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1 OVERVIEW 



The Generic Print System (GPS) is a comprehensive 
software printing system that simplifies the 
tasks your application must perform to output to 
the printer. These tasks have been made "generic" 
whenever possible, so that you can use GPS with a 
wide variety of applications and output devices. 
GPS works in a clustered environment, within a 
network, or on a standalone system. 

Four dynamically- installed GPS system services 
pass the data to the printer or plotter for output 
and handle communications within the cluster or 
network. Your application makes requests of GPS; 
GPS tracks the print job and feeds back the in- 
formation your application requests about the job. 

To make applications programming for printing 
routines as free from hard-coded, device-specific 
operations as possible, GPS provides the following 
device- independent features: 

• Sequential Access Method (byte stream) 
access to GPS devices . 

• The Generic Print Access Method (GPAM) is 
an easy-to-use library of printing 
routines that you can use to access a GPS 
device, as well as to print text and/or 
graphics; GPAM provides a device- 
independent method to add complex text 
formatting, such as multiple text 
typefaces and styles, or graphics. 

• A unique device driver that controls the 
device and translates the generic output 
your application sends to GPS into 
device-specif ic control commands. The 
GPS distribution disk includes one device 
driver for each type of supported 
printing device. 
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• A programmatic interface your application 
can use to check printer status or to 
send printer control coimnands (such as 
pause and restart) . 

• Identical calls to use when sending 
output to either a direct or a spooled 
device . 

In addition, the Generic Print System includes the 
Print Manager, an interactive utility used to 
install and monitor printers. The Print Manager 
can also be used to print files. It is described 
in detail in the Printing Guide . 



VSINg THIS MANUAL 

This manual describes how an application program 
uses the Generic Print System and the Generic 
Print Access Method to print and to perform 
printer control operations. 

It is assumed that the programmer has basic 
familiarity with programming in the CTOS 
environment. If this is not the case, read 
"Getting Started," in the CTOS Programmer's Guide. 
Also read Chapters 1 through 3, and Chapter 13, 
"Sequential Access Method," in the CTOS Manual . 

Installation and configuration of the Generic 
Print System is described in the Printing Guide 
and the Generic Print System Release Notice. 

In general, the Generic Print System is used in 
the same way whether it is running on a standalone 
system or on a workstation within a cluster. 
Throughout this manual, whenever the term cluster 
is specified, it is assumed that the statement 
also applies to standalone configurations. 
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GPS can be used with shared resource processors as 
masters . When the term master workstation is used 
in the manual it means either a workstation or a 
shared resource processor . 

Chapter 2, "Introduction to the Generic Print 
System, " provides an overview of programming in 
the GPS environment and describes how the Generic 
Print System functions . 

Chapter 3, "Using GPS Byte Streams, " discusses the 
simplest type of printing your application can 
perform with the Generic Print System. GPS byte 
streams is a quick, efficient way to output 
text-only documents. 

Chapter 4, "Using the Generic Print Access 
Method, " discusses using GPAM to send 
device- independent formatting to the printing 
device. GPAM allows fully formatted text and 
graphics output . 

Chapter 5, "Using GPS Requests," describes the 
request and discusses how your application system 
can use the power of the Generic Print System to 
provide your user with more complex printing 
facilities . 

Chapters 5 and 7 are reference chapters that de- 
scribe the GPAM and GPS operations in great 
detail . 

Chapter 8, "Troubleshooting, " lists error codes 
and error conditions you may encounter . 

Appendix A briefly discusses how to interface with 
existing non-GPS applications. 

Additionally, there are example programs on the 
distribution disk that demonstrate the various 
features of GPS. These examples are referred to 
in this manual, but you do not need them to use 
the manual . 
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RELATED DOCUMENTATION 



For a complete list of Convergent Technologies 
publications, see the "Guide to Technical Docu- 
mentation" in the Executive Manual or similar 
command- line interpreter manual for your operating 
system . 

The CTOS Operating System Manual describes the 

CTOS operating system. It specifies services for 
managing processes, messages, memory, exchanges, 
tasks, video, disks, keyboard, printer, timer, 
communications, and files. In particular, it 
specifies the standard file access methods: SAM, 
the sequential access method; RSAM, the record 
sequential access method; and DAM, the direct 
access method. 

The CTOS Programmer's Guide (formerly titled the 
System Programmgr ' S guide) is a reference guide 
for use in programming under the CTOS operating 
system. It describes CTOS programming practices 
and introduces the system to the programmer who is 
using it for the first time . 

The Printing Guide provides the information you 
need to install any supported printing device on 
your standalone workstation or within your 
cluster, and describes the Print Manager, the 
interface to the Generic Print System. It also 
describes how to use the Print Manager on a day- 
to-day basis to monitor the status of printing 
devices and to control the printer . Printer 
troubleshooting is also discussed. 
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2 INTRODUCTION TO THE GENERIC PRINT SYSTEM 



The Generic Print System (GPS) consists of four 
dynamically installed system services that work 
together to control the printing device and to 
handle coimnunication between application systems, 
the operating system, and the printers or plotters 
currently installed. These system services are as 
follows : 

• Routing Switch 

• Device Driver 

• Spooler 

• Queue Manager 

The GPS system services are described in more 
detail later in this chapter. 

A dynamically installed s ystem service is a 
modular part of the operating system that resides 
in workstation memory and can be added or removed 
at any time. System services, therefore, are not 
a part of the operating system when it is first 
installed, nor are they resident after a system is 
started unless you make special entries in your 
system initialization file for their installation. 

An application system can make a request of any 
system service at any time . 

System services and the way that they work are 
described in detail in the CTOS Operating System 
Manual • Also consult the CTOS Programmer's Guide 
for information on interfacing with system 
services . 

The Generic Print System handles all print 
requests your application makes to a device under 
its control. Whenever a printer is installed with 
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GPS, a printer name is assigned that is unique 
within the cluster. This printer name is all your 
application system needs to know in order to send 
a print request to any installed printer. GPS 
handles the routing of the request to the 
appropriate location, wherever the printer is in 
the cluster or network. In the same way, your 
application does not need to know whether the 
printing device has been set up for direct or 
spooled printing, or whether it is a serial or 
parallel device. 

In addition to the GPS system services, GPS 
includes the following features: 

• Generic Print Access Method (GPAM) , a 
library of object modules procedures used 
for text and graphics formatting. 

• Print Manager, an interactive utility 
that provides print, status, and instal- 
lation facilities for GPS. Using the 
Print Manager is described in the 
Printing Guide- 

PROGRAMMING IN TEIE GPS EWVT RONMENT 

GPS provides three ways that your application can 
make print requests : 

• using Generic Print System byte streams, 
which communicate with the GPS system 
services through the Sequential Access 
Method (SAM) 

• using the Generic Print Access Method 
(GPAM) , a library of object module pro- 
cedures which send generic formatting 
commands to the printer through the 
Sequential Access Method 
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• using Generic Print System requests, 
which communicate directly with the GPS 
system services 

These three methods are shown in Figure 2-1. In 
addition, GPS provides status and control 
functions that you can use whether you are using 
byte streams, GPAM, or direct calls to GPS as the 
method to transfer data to the printer. 

GPS BYTE STEIEAMS 

Using GPS byte streams is the simplest way for 
your application to print a document. With this 
method, you specify the printer name for the 
Sequential Access Method and it passes the text to 
the GPS system services for you. Your application 
does not even have to know that any of the GPS 
system services exist. 

Figure 2-2 shows a simple printing application of 
this type. (See Chapter 3, "Using GPS Byte 
Streams," for more information and an example of 
this type of simple application.) 
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Figure 2-1. Three Methods of Printing with GPS 
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Figure 2-2. A Sinple Printing ^plication 



TEE GENERIC PRINT ACCESS METHOD 

If you want to include formatting attributes, such 
as boldface text, different font styles, or 
graphics with your text, you can use calls to GPAM 
which work very much like a byte stream. When you 
use GPAM you include generic formatting infor- 
mation with the data . GPAM handles communications 
with the GPS system services for you in the same 
way that byte streams do; in addition, the generic 
formatting commands it provides are translated by 
GPS for the specific printer to which the output 
is sent . 

All printers are not created equal; some printers 
may not be capable of outputting the formatting 
features you have specified. In these cases, GPAM 
is designed for graceful de gradation . If the 
output device cannot perform a certain function, 
GPAM instructs it to do the next best thing. For 
example, if your printer cannot output boldface 
text, GPAM simply outputs all such text as plain 
text. GPAM does not reject your print rec[uest; it 
executes it as well as it is able, subject to 
hardware (and sometimes software) limitations. 
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(Constructing a GPAM data stream is described in 
Chapter 4, "Using the Generic Print Access 
Method." Each procedure from the Generic Print 
Access Method library is described in detail in 
Chapter 6, "GPAM Procedures.") 



GENERIC PRINT SYSTEM REQUESTS 

Direct calls to GPS can be made for two types of 
functions 

• printing (output functions) 

• status inquiry or printer control (status 
and control functions) 



Output Functions 

GPS byte streams or GPAM send output to the 
printer through the GPS system services . 

Note that byte streams, GPAM, and GPS output 
requests must be used separately; your application 
should choose only one output request at a time . 

It is easier to use GPS byte streams or GPAM to 
print than to try to make output requests directly 
of GPS. 



Status and Control Functions 

The GPS status and control functions, all of which 
make calls to one of the GPS services (the routing 
switch) , can be used with any of the three output 
functions . You can check status and send control 
coimnands only by making these calls directly to 
GPS . 
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Using the additional functions the routing switch 
offers, you could, for example, display a list of 
printers for the user to choose from, or you could 
make status enquiries and send the printing device 
control commands like pause and restart. 

Figure 2-3 shows this type of more sophisticated 
printing application. 
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Figure 2-3. A Sophisticated Printing ^plication 



The status and control functions also include a 
function to find out the users assigned default 
printer name. 

Making calls to GPS is described in Chapter 5, 
"Using GPS Requests . " The requests themselves 
are described in detail in Chapter 7, "GPS Routing 
Switch Requests . " 
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AN OVERVIEW QE THE GENERIC PRINT SYSTEM SERVICES 



Four different system services make up the Generic 
Print System. GPS is modular, so the print system 
can be tailored to specific needs. Only those 
modules that are needed are installed, and not all 
modules are needed for every workstation in a 
cluster. Several installations of the same system 
service can also exist within each cluster. 

The following is a brief description of the four 
GPS system services : 

• The routing switch routes rec[uests to the 
designated printing device and coordi- 
nates the work of the entire Generic 
Print System. 

The routing switch also handles printer 
control commands (such as pause and 
restart) , and status enquiries . Routing 
switches within a cluster or network 
communicate with each other to pass 
requests or status information. 

A routing switch is installed on each 
workstation to which a printer is 
attached. In addition, a routing switch 
is usually also installed on the master 
workstation of each cluster. 

• The device driver controls the device and 
translates the Generic Print Access 
Method byte stream it receives into 
device -specific commands. Device drivers 
are usually unique for each type of 
printing device. 

A device driver is installed on the 
workstation to which the device it 
controls is attached. 
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• The spooler gives a print request to the 
Queue Manager to place in the. print 
queue. When the printing device is free 
to print, the spooler asks for the print 
request back again. 

The spooler is installed on each work- 
station to which a spooled device is 
attached . 

• The Queue Manager handles all queues of 
jobs for the cluster. It is used by 
other applications, such as Batch or 
SNA/RJE, as well as by GPS. 

A Queue Manager must be installed on the 
master workstation of each cluster where 
spooled devices are installed, or on any 
standalone system where you want to have 
spooled printing. Installation of these 
services and the configuration of 
printers and plotters for use with GPS is 
described in the Printing Guide. 

Figures 2-4 through 2-10 at the end of this 
chapter show how output data and status infor- 
mation flow from service to service within the 
print system. 



THE GPS ROUTING SWITCH 

The GPS routing switch is the focal point of the 
Generic Print System. When an application makes a 
print request, the routing switch sends the 
request to the device driver for the specified 
device and monitors the printing process. Printer 
control commands or requests for status infor- 
mation are also handled by the routing switch. 
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The routing switch keeps a list of installed 
printing devices for your standalone workstation 
or cluster. It polls this list regularly to check 
printer activity. 

A routing switch must be installed on each 
workstation to which a printer is attached. If 
printers are to be shared within a cluster, or 
shared with another node in a CT-Net network, then 
there must also be a routing switch at the master 
workstation, whether or not a printer is attached 
to it . 

The routing switch acts as the request interface 
between your application and the Generic Print 
System. Requests are described in Chapter 5, 
"Using GPS Recjuests . " 



THE GPS DEVICE DRIVER 

There is a specific device driver for every 
installed device in your print system. Device 
drivers are written specifically for each type of 
device to drive the printer and to translate a 
device- independent GPAM data stream into 
device- specific coimnands. 

Your application system communicates with the 
device drivers indirectly, through the routing 
switch . 
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Despite the specific capabilities of the printing 
device, the output produced depends on the device 
driver used. Output can be as follows: 

• draft quality output, without special 
formatting such as boldface or 
underscored text 

• letter quality output, which includes 
formatting such as boldface, underscore, 
superscript, and siabscript text 

• graphics 

Both text and graphics can be printed on the same 
page within a document. 

The Generic Print System is distributed with 
device drivers for several supported printing 
devices . 

There is a generic device driver, called 
LptSimpleDD .Run, that can be used with most 
printers if you only want to produce draft quality 
output . 

There is also a daisy wheel driver, DaisyDD.Run, 
that works with several of the daisy wheel 
printers and produces letter quality text. 

Additionally, there are drivers for publication- 
quality laser printers. 

Information on specific supported printing devices 
and device drivers can be found in the Printing 
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■raE SPOOLER 



The spooler receives print requests from the 
routing switch for those printing devices it 
controls . 

The spooler makes a recjuest that the Queue Manager 
place a temporary copy of the document in the 
queue for the specified printer. Since queues are 
priority-based, the request may or may not be 
placed at the end of the queue. When the printer 
is free, the spooler requests the next job in the 
queue . 

One spooler must be installed on each workstation 
to which one or more spooled printing devices are 
attached . 



THE QUEUE MANAGER 

The Queue Manager is a GPS system service that is 
also used by other applications such as Batch. 
The Queue Manager queues and dequeues files as 
requested , 

For non-GPS applications, the Queue Manager 
references a file called Queue. Index to establish 
queues at installation time. GPS, by contrast, 
automatically creates queues as needed. 

Your application does not need to make requests 
directly to the Queue Manager . 

The GPS Queue Manager has the ability to 
dynamically establish and remove queues without 
referencing the Queue. Index file. 
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For each standalone system or cluster of 
workstations, only one Queue Manager is installed. 
Within a cluster of workstations, the Queue 
Manager is installed at the master workstation. 

When the Queue Manager is installed, the number of 
queues specified must be large enough to 
accommodate all the queues used by non-GPS 
applications (those defined in Queue . Indexb) , plus 
those that will be used by the print system. 
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Figure 2-4. Direct Printing with GPS 
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Figure 2-6, Printer Stratus Queries with GPS 
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Figure 2-7. Issuing Printer Control Commands 
with GPS 
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3 USING GPS BYTE STREAMS 



The CTOS Sequential Access Method (SAM) provides 
device -independent calls an application can use to 
access real devices, such as the video display, 
keyboard, or printer. These calls send a generic 
stream of bytes, called a byte stream , through SAM 
to the specified device. 

The simplest way for your application to use the 
Generic Print System is to print through GPS byte 
streams (part of the Sec[uential Access Method) . 

This method passes ASCII characters to the 
printing device for printing. The device driver 
passes the output to the printer interpreting the 
characters required for simple draft output. 

You may want to use this type of printing, for 
example, if your application creates files that do 
not contain special formatting, but consists of 
characters, line feeds, and form feeds. 

Using the Sequential Access Method for all kinds 
of devices is explained in detail in the CTOS 
Manual . Note that printer byte streams and 
sppglgr byte streams as described in the CIQS 
Manual are not GPS byte streams . Using GPS byte 
streams is described below. 



NOTE 

If you want to convert an application not 
originally written to use the Generic Print 
System, the most expedient mode of conversion 
is to print the output currently produced 
through GPS byte streams. See Appendix A, 
"Converting Non-GPS Applications, " for more 
information . 
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GPS BYTE STREAMS 



To use GPS byte streams when you make the call to 
OpenByteStream, specify the GPS printer name 
enclosed in square brackets, as shown below: 

[LaserJet] 

Note that you do not have to give the printer 
location; only the printer name is required. In 
addition, your application does not need to know 
whether the device is set up for direct or spooled 
printing. The Generic Print System handles all 
this . 

(You can find out this type of printer information 
by using the GetGPSDeviceConf ig call, described in 
Chapter 7 . ) 

Specifically, the calls used to send output to a 
GPS device are as follows: 



OpenByteStream 



Opens the byte stream 
and specifies the GPS 
Byte Stream Work Area. 



WriteBsRecord 



Writes a specified count 
of bytes to the GPS Byte 
Stream Work Area. 



WriteByte 



Writes one byte only to 
the GPS Byte Stream Work 
Area . 



CloseByteStream 
ReleaseByteStream 



Closes the byte stream. 

Releases abnormal closes 
and fatal errors. 
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Note that to set the printing mode with GPS you 
should use the routing switch request, 
SetlmageModeGPS, rather than SetlmageMode as 
described in the CTQS Manual- 

An example has been included on the distribution 
disk to show how a simple Copy program might use 
byte streams to open a file and copy it to a GPS 
device . 



LINKING YOUR PROGRAM TO INCLUDE GPS BYTE STREAMS 

You should be sure that when you link your program 
that the version of CTQS. lib and SAMGen.obj that 
you are using includes GPS byte streams . See your 
Generic Print System Release Notice for more 
information . 

Also note that SAM can be customized to include 
the capability to handle only those device types 
you specify. For example, if you intend to use 
only GPS, you may want to remove entries for 
printer byte streams and spooler byte streams 
(both for non-GPS printing devices) that are no 
longer applicable. See "Building a Customized 

SAM, " in the CTQS Programmer ' s Guide for more 

information . 



EXAMPLE 

A sample program illustrating some of the concepts 
discussed in this chapter can be found on your 
distribution disk. 
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4 USING THE GENERIC PRINT ACCESS METHOD 



The Generic Print Access Method (GPAM) is a 
library of object module procedures (GPAM. lib) 
provided for use with GPS. GPAM handles 

communications with the GPS system services for 
you in the much the same way that byte streams do . 
In addition, it provides the following: 



• generic object module routines that can 
be translated by each GPS device driver 
into device-specif ic formatting commands 

• the following character formatting 
attributes : 

boldface 
underscore 
over strike 
color 

superscript and subscript 
font 

• graphics formatting 

• enables you to mix graphics and text on 
the same page 

• controls character placement within the 
page; for example, you can specify line 
feed measurements and placement of the 
character relative to the left margin 

• defines printing parameters, such as 
number of copies and priority 
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You can specify graphics output with GPAM in one 
o f two ways : 

• Use a series of GPAM graphics routines: 

lines can be specified in any color as 
solid, dashed, dotted, or dash-dot 

closed polygons can be specified with 
separate interior and exterior colors, 
hollow, solidly filled, or filled with 
diagonal lines or crosshatching 

• Use the GPAM write routine, 
GPAMWriteRecord, to write out an existing 
CGM file produced with the Graphics 
library routine, WriteCGM. (The graphics 
library is available separately.) 



NOTE 

You can print graphics and text with GPAM. 
GPS byte streams can only be used to output 
text . 



With GPAM, as with GPS byte streams, you do not 
have to give the printer location, only the 
printer name is required. In addition, your 
application does not usually need to know whether 
the device is set up for direct or spooled 
printing. The Generic Print System handles all 
this. GPAM data streams can also be directed to a 
file. 
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When a device driver receives a GPAM data stream 
that includes formatting it cannot produce, those 
commands are ignored and the document is printed 
according to the capabilities of the device. For 
example, if a document including text and graphics 
is sent to a text-only printer, the text is 
printed and the graphics are not . 

Table 4-1 includes a list of the GPAM procedures 
with a brief description of each. 

You can use GPAM in conjunction with calls to GPS. 
GPS requests are discussed in Chapter 5, "Using 
GPS Requests . " 



LINKING WITH GPAM 

To use GPAM, you must specify GPAM. lib in the 
Libraries field of the Linker command form when 
you link your application. 

The linking is done automatically from the 
[Sys] <sys> directory if GPAM. lib is there. 
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Table 4-1 
GPAM PROCEDURE SUMMARY 
(Page 1 of 4) 



GPAMBeginBold 
GPAMBeginBound 

GPAMBeginltalic 
GPAMBeglnOver strike 

GPAMBeginPage 

GPAMBeglnRaster 
GPAMBeginTransparent 

GPAMBeginUnderscore 
GPAMClose 



Prints all subsequent 
characters as boldface 
text . 

Adjusts proportional text 
generated by an applic- 
ation to conform to the 
limitations of an output 
device . 

Prints all subsequent 
characters as italic text. 

Indicates that all sub- 
sequent text is to be 
over struck with a spec- 
ified character. 

Causes a new physical page 
to begin and defines a 
series of attributes about 
the new page . 

Indicates raster graphics 
output is to begin. 

Indicates that all 

subsequent output until 
GPAMEndTransparent is 
called is to be passed 
through to the output 
device and is not to be 
processed in any way by 
the output device driver . 

Indicates that all sub- 
sequent text is to be 
underscored . 

Closes the specified GPAM 
data stream. 
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Table 4-1 
GPAM PROCEDURE SUMMARY 
(Page 2 of 4) 



GPAMEndBo 1 d 




InoT d IDT" i nt" 1 nd 


GPAMEndBound 


Terminates 


bound printing. 


GPAMEndltalic 


Terminates 


italic 


GPAMEndOver str ike 


Terminates 


over str iking . 


GPAMEndRaster 


Terminates 
output . 


raster graphics 


GP AMEndTr ansp a r en t 


Terminates 
output . 


transparent 


GPAMEndUnderscore 


Terminates 


underscoring . 


GPAMLineFeed 


Causes the output position 
to move vertically down by 
an amount equal to the 
most recent value set by 
GPAMSetSLD . 


GPAMOpen 


Opens a GPAM data stream 
and specifies all document 
level parameters, for ex- 
ample number of copies. 


GPAMP 1 aceChar acter 


Places a single character 
on the current line an 
absolute distance from the 
left side of the page. 


GPAMRe lease 


Abnormally closes the 
output stream in the case 
of error or an unsuccess- 
ful GPAMClose. 


GPAMRepo s i t i on 


Causes subsequent output 
to be placed starting at 
the location specified. 
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Table 4-1 
GPAM PROCEDURE SUMMARY 
(Page 3 of 4) 



GPAMSetFont 



GPAMSetSLD 



GPAMSetColor Specifies which color 

should be used for all 
subsequent text . 

Specifies the font name, 
its width, and its height. 

Specifies the vertical 
distance to move for each 
subsequent GPAMLineFeed or 
Return (the single line 
distance) . 

GPAMSetTranslateTable Specifies the name of the 

translate table (12 bytes 
or less) to use to map 
internal 8 bit character 
codes into the codes to be 
presented to the output 
device . 

GPAMSetVerticalOf f set Used for subscripts and 

superscripts . 



GPAMWhiteSpace 



GPAMWriteRecord 



Puts a specified amount of 
white space at the current 
position. 

[text and graphics] 

Writes the specified bytes 
to the open byte stream. 



GPAMGrBeginGraphics 



Used to specify the be- 
ginning of any series of 
GPAM Graphics routines or 
GPAMWriteRecord routines 
containing CGM- format 

graphics information. 
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Table 4-1 
GPAM PROCEDURE SXJMMARY 
(Page 4 of 4) 



GPAMGrColorTable Sets the colors to be used 

with graphics routines . 

GPAMGrEndGraphics Terminates the definition 

of graphics output. 

GPAMGrFillColor Sets the color used by 

GPAMGrPolygon for interior 
fills. 

GPAMGrHatchlndex Sets the hatch pattern 

used by GPAMGrPolygon to 
fill the figure. 

GPAMGrlnteriorStyle Sets the style used by 

GPAMGrPolygon to fill the 
figure . 

GPAMGrLineColor Sets the color used by 

GPAMGrPolyLine. 

GPAMGrLineType Sets the line type used by 

GPAMGrPolyline. 

GPAMGrPerimeterColor Sets the color used by 

GPAMGrPolygon to draw the 
polygon perimeter . 

GPAMGrPolygon Draws a closed polygon. 

GPAMGrPolyLine Draws a sequence of con- 

nected lines. 
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OPENING AN D CLOSINTG A GPAM DATA STREAM 



To begin a GPAM data stream, you must use the 
procedure GPAMOpen, then follow with other GPAM 
routines. GPAMOpen specifies the device or file 
to which you want to print and gives print recjuest 
parameters, for example, document name, time to 
begin print, number of copies, timeout, and 
priority. 

In effect, GPAM opens a GPS byte stream, then 
writes data in GPAM format to the specified device 
driver. The driver translates the generic 

commands and data is printed as specified. GPAM 
requires a 300 -byte work area and a buffer area 
from 1024 to 4800 bytes in size. 

For normal circumstances, the data stream is 
closed with the procedure GPAMClose. In the case 
of an unsuccessful close or a fatal GPS error, you 
should use GPAMRelease to close the output stream. 
GPAMRelease does not attempt to write out any 
partially full buffers. 



DATA SIREAM STRUCTURE 

You can use GPAM procedures to describe your page, 
line spacing, character placement within the line, 
and character attributes such as bold, underscore, 
superscript or subscript. 

Once these attributes are set, GPAM data is output 
similarly to byte stream data, with the procedure 
GPAMWr iteRecord . 
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A typical secjuence that would begin a page, print 
out some boldface and underscored characters, then 
change line spacing and print out normal 
characters might be the following: 

GPAMOpen 

GPAMBeginPage 

GPAMBeginBold 

GPAMBeginUnderscore 

GPAMWriteRecord 

GPAMEndUnder score 

GPAMEndBold 

GPAMWriteRecord 

GPAMWriteRecord 

GPAMClose 

A complete example showing construction of a GPAM 
document is included on the distribution disk. 

Once a GPAMBeginGraphics call has been made, all 
calls must also be Graphics calls, until you end 
the graphics sequence with a call to 
GPAMEndGraphics . 

When including text and graphics on the same page 
it is recommended that all text be written in a 
block, then use GPAMReposition before writing an 
area of graphics data. The device driver buffers 
up to a full page of data to handle information. 



Using the Generic Print Access Method 4-9 



LEGAL CEIARACTERS 



Data written to the output stream may contain any 
of the 256 characters included in the CTOS 
Standard Character Set. See the CTOS Operating 
System Manual for a complete list of legal 
characters . 

The Form Feed (OCh) , Carriage Return (ODh) , 
Horizontal Tab (09h) , and Return (OAh) can all be 
included as a part of the text written to the 
output stream. For each, the device driver 
generates the appropriate action. 

Note that return (OAh) is the preferred method for 
starting a new line. (OCh and ODh are supported 
for compatibility with ASCII character sets.) 
Form feed is not the preferred method for starting 
a new page; use GPAMBeginPage instead. 

Depending on the device driver, the inclusion of 
some characters, for example, the vertical tab 
(OBh) , may cause printer action. This should only 
be included if you really want the printer to 
space vertically on the page. 



PAGINATION 

Page set up is specified with the procedure 
GPAMBeginPage . At this time you can set 

parameters such as output bin, special form, 
portrait or landscape aspect, page length, and 
page width. 

If you have form feeds within any text you write 
out, the printer will take the appropriate action. 
The last parameters set for GPAMBeginPage are 
carried over for that new page . 
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PRINT POSITION AND CHARACTER PLACEMENT ON THE PAGE 



Page coordinates are specified for GPAM in 20t:hs 
of a point. The coordinate base specifies the 
left edge of the character and the base line. For 
example, the first character on a page would 
usually appear at the position 0,240. See Figure 
4-1. 



Left Edge of Paper 




MS-011 



Figure 4-1. Character Placement 



You can set line feed distance with GPAMSetSLD. 

For most line feeds, you should use Return (OAh) . 
GPAMLinefeed moves the print position down one 
line without any horizontal movement. 

Carriage Return (ODh) moves the print position 
back to the beginning of the line without any 
vertical movement . 
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The procedure GPAMReposition can reposition the 
print position to anywhere in the page. 

Character placement within a line can be set with 
GPAMPlaceCharacter . This routine recjuires fewer 
parameters than GPAMReposition and is, therefore, 
more efficient to use if no change in vertical 
position is desired. 



ASSIGNING TEXT ATTRIBUTES 

You can specify that text be boldface, 
underscored, superscript, subscript, a specified 
color or font, or overstruck by a specified 
character . 

With bold, overstrike, and underscore, the 
attribute can be turned on and off, for example, 
GPAMBeginBold/GPAMEndBold . 

Superscript and subscript are set with the 
procedure GPAMSetVerticalOf fset, which moves the 
current print position up or down a fraction of 
the current line feed distance (set with 
GPAMSetSLD) . The distance moved depends on the 
device driver. If you choose not to use the 
default value, however, you can set the 
superscript or subscript to be up to 8 times the 
value of the default distance. 

To terminate superscript or subscript you must use 
GPAMSetVerticalOf fset again to return the offset 
to 0 (the baseline) . You do this by assigning the 
appropriate positive (+) or negative (-) value. 

GPAMSetColor sets the color of subsequent text. 
The colors are defined with GPAMColorTable . 
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GPAMSetFont specifies a font name, width, and 
height. The font height is equivalent to the font 
point size. If you choose not to use the default 
width of a font, you can set width and height 
separately. 



TIMEOUTS 

I f you want to get control back during your GPAM 
output session (to issue a printer status rec[uest 
for example) , you can also set a timeout with 
GPAMOpen. When the device driver times out, it 
cancels the current command. 

Generally, when you get a timeout from the device 
driver, you should immediately check printer 
status, then, to resume processing, reissue the 
command that timed out. 

To avoid hanging-up the system, make a timeout 
call as a general caution after each GPAM call, 
for example, after GPAMBeginBold, after 
GPAMEndBold, and so on. 

Note that with GPAMWriteRecord, the current 
command is not cancelled. A number of bytes may 
have been already transferred to the device. 

If you get a timeout after a GPAMWriteRecord, you 
should look at the number of bytes returned to 
determine where in the write procedure the timeout 
occurred. Then you can reissue the call 

specifying a write for the number of remaining 
bytes to print. 
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SENDING NQ N-GPAM C OMMANDS TO THE PRINTING DEVICE 



Note that if you want to send device -specific 
commands not supported with GPAM, a special 
procedure (GPAMBeginTransparent) is provided so 
that the commands can be sent within your GPAM 
data stream , 

GPAMBeginTransparent sets GPAM ' s data mode to 
transparent. In that case, subsec[uent data from 
GPAMWriteRecord is passed as is to the printing 
device without any translation by the GPS device 
driver. To reset GPAM's data mode back to normal, 
call the GPAMEndTransparent routine. 



USING GPAM EQR GRAPHICS 

With GPAM you can easily include both figures and 
alphanumeric characters on the same page. You can 
use GPAM procedures to write all your text, then 
use GPAMReposition to change the print position 
and write out the figures. 

When the page is printed out, the device driver 
buffers the entire page, then prints it out line- 
by-line, with all text and graphics. 

The printing of all graphics must be preceded by a 
call to GPAMGrBeginGraphics , which should itself 
be preceded by a call to GPAMReposition. 
Subsequent calls may be either of the following: 

• GPAM graphics routines 

• GPAMWriteRecord routines that write out 
an existing CGM file originally created 
using the Graphics. lib routine, WriteCGM 

End a sequence of calls to graphics routines with 
a call to GPAMGrEndGraphics . 
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CTIAPHICS POSITIONING 

Whenever a call to GPAMGrBeginGraphics is made, 
the picture is placed by default with its 
upper- left corner at the current print position. 
To change this, you must make a call to 
GPAMReposition before making the 

GPAMGRBeginGraphics call. 



NOTE 

Pictures cannot cross page boundaries . 



SCALING 

When the call to GPAMGrBeginGraphics is made, the 
width and height of the graphics area is 
specified. The device driver automatically scales 
graphics Output to fit the space designated. 



THE OlAPHICS ROUTINES 

With graphics routines you can set a color palette 
and create lines or closed polygons with a variety 
of different attributes. 

GPAMGrColorTable sets the color palette. The 
color you define in the palette can be 
subsequently selected when you draw lines or 
polygons . 

Lines can be specified in any color as solid, 
dashed, dotted, or dash-dot. Use GPAMGrPolyLine 
to specify the line coordinates. Up to 8191 
points can be specified. 
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GPAMGrLineColor specifies the col6r for subsec[uent 
lines, from the colors array specified in 
GPAMGrColorTable . 

GPAMGrLineType specifies the line as one of the 
following: 

solid 

dashed 

dotted 

dash dot 

line dash dash 

line dash 

line blank _____ 
line blank blank _ _ _ _ 

Some devices may use other patterns for some of 
the line types defined above. You should e3<peri- 
ment with your output device to determine what 
line types it supports. 

Closed polygons can be specified with separate 
interior and exterior colors, hollow, solidly 
filled, or filled with diagonal lines or 
crosshatching . 

Use GPAMGrPolygon to specify the array of coordi- 
nates to be connected to specify the boundaries of 
the polygon. 

The GPAMGr Interior Style routine sets whether the 
subsequent polygons have a visible border and 
whether the interior fill will be hollow, solid, 
or crosshatched . 

If a perimeter exists, GPAMGrPerimeterColor se- 
lects the color of the perimeter line for any 
subsequent polygons . 
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GPAMGrHatchI ndex sets interior hatching for either 
a narrow or wide diagonal or crosshatching . 

GPAMGrFillColor sets the interior colors for the 
polygon. 

A typical sequence of graphics routines might be 
as follows: 

GPAMOpen 

GPAMReposition 
GPAMGrBeginGraphics 

GPAMGrSetColorTable 
GPAMGr I nter i or S ty 1 e 
GPAMGrHatchlndex 
GPAMGr P o lygon 
GPAMGr EndGr aphi cs 
GPAMClose 

A sample GPAM graphics routine is included on the 
distribution disk. 



VSINg CGM 

If you want to print files that were created using 
the Graphics. lib routine (WriteVDM) , use 
GPAMWr iteRecord . 

A typical sequence of calls would be as follows: 
GPAMRepost i on 
GPAMGrBeginGraphics 
GPAMWr iteRecord 
GPAMGrEndGraphics 
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5 USING GPS REQUESTS 



Most application systems use GPAM or GPS byte 
streams to print. If, however, you want to add 
status and control functions to your application, 
or if you want more direct control over the 
printing process, you can use the services of the 
Generic Print System by making direct requests of 
the routing switch. 

A large portion of the routing switch's function 
is the generation, collection, presentation and 
control of GPS data. The information about each 
GPS device is collected and maintained by the 
routing switch installed at the same workstation 
as that device. This routing switch disseminates 
the information to the other routing switches in 
the cluster and network. Data describing GPS 
devices throughout the cluster and network is 
provided to an application by the nearest routing 
switch . 

You can use routing switch operations, as 
described below, to enhance your application's 
printing facilities: 

• to get a list of printing devices that 
can be legally specified, or to get the 
name of the user's designated default 
device 

• to check and report on the status of any 
printing device or print request 

• to send printer control commands, such as 
pause and restart, from your application 
to the printing device 
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• to add a check for such conditions as 
printing speed, whether the printing 
device can handle graphics output, 
whether the device is spooled, or whether 
there is enough room on the spooler 
volume for the spooled print request you 
are about to make 

You can use routing switch requests to print 
instead of using byte streams or GPAM to copy 
information . 

Table 5-1 gives a summary and description of the 
routing switch requests . The requests are 

described in detail in Chapter 7, "GPS Routing 
Switch Requests . " 

MAKING A PRINT REQUEST WITH GPS OUTPUT FUNCTIONS 

Most applications use GPS byte streams or GPAM to 
print, rather that communicating directly with any 
of the GPS system services. Such applications use 
only the GPS status and printer control requests, 
discussed below in "Status Functions, " and 
"Controlling the Printing Device." 

If you should use direct GPS requests to print, a 
typical sequence would be as follows: 

OpenGPSFlle 

SetGPSParams 

WriteGPSFile 
CloseGPSFile 

Whenever you do an OpenGPSFile you should also use 
the request SetGPSParams to control queuing and 
printing of the document. SetGPSParams sets such 
parameters as number of copies, start and stop 
location, and priority. 
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Table 5-1 
SUMMARY OF ROOTING SWITCH REQUESTS 
(Page 1 of 2) 



CloseGPSFile 



DeleteGPSJob 



GetQpsDefaultPr inter 



GetGPSDevHi s t ory 



GetGPSDeviceConfig 



GetGPSDocInfo 



GetGPSNetList 



GetC^sSplVolStatus 



Terminates an output ses- 
sion, closes the open device 
driver and releases assoc- 
iated hardware . 

Causes a document queued at 
a device to be deleted. 

Used by application programs 
to select the default GPS 
device as specified in the 
logged in user file. 

Provides a list of documents 
that have been printed by a 
particular device, indicates 
when the printing started 
and finished, and the status 
of the document upon 
termination . 

Returns configuration infor- 
mation about a particular 
device . 

Used to query GPS about the 
status of documents that are 
printing or are waiting to 
be printed at a selected 
device . 

Returns a list of all GPS 
output devices accessible 
from the workstation running 
the application. 

Returns the number of 
51 2 -byte pages remaining on 
the spooling volume. 
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Table 5-1 
SUMMARY OF ROUTING SWITCH REQUESTS 
(Page 2 of 2) 



GetGPSStatus request 



OpenGPSFile 



ProvideGPSPassword 



QueueGPSFile 



SetGPSControl 



SetGPSParams 



SetGPSRestart 



SetlmageModeGPS 



WriteGPSFile 



Returns 
for a 
device . 

Opens a 
output . 



status information 
particular output 

GPS device for 



Provides a password so that 
printing of a password pro- 
tected document, printed in 
security mode can start . 

Allows an application to 
specify the name of add a 
document file that is to be 
added to a spooled generic 
device ' s queue . 

Provides the mechanism for 
applications to send control 
commands to generic print 
devices . 

Provides information to the 
GPS system about a job that 
has just been opened with 
the OpenGPSFile request. 

Provides the mechanism for 
applications to send restart 
control commands to generic 
output devices that have 
previously been paused. 

Sets normal, image, or bi- 
nary mode for a GPS device. 

Transfers a number of bytes 
from memory to the printer . 
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Whenever you do an OpenGPSFile you should also use 
■the request SetGPSParams to control queuing and 
printing of the document. SetCT*SParams sets such 
parameters as number of copies, start and stop 
location, and priority. 

If you specify security mode for printing when you 
call SetGPSParams, the printing device pauses 
before printing to wait for a password to be 
entered. To supply the password, your application 
should use ProvideGPSPassword. 



SPOOLED OR DIRECT PRINTING 

In most cases, your application does not need 
information about whether the device is a direct 
or spooled device in order to print. If you want 
to know this information, you can use 
GetGPSDevConf ig to query GPS about the device. 

You should be aware that requests for multiple 
copies cannot be processed by a direct printing 
device. However, since GPS always tries to do the 
best it can with your request, it does accept 
such a recjuest to a direct device and prints one 
copy only. 

For spooled printing devices, as an alternative to 
the sequence outlined above, you can use 
QueueGPSFile . With this request the normal GPS 
process of queueing a file by copying a temporary 
file to the spooler volume is bypassed and the 
file is opened directly by the spooler. However, 
the file must be accessible from the spooler for 
the device specified. For example, a file on a 
local file system could not be queued for a device 
on the master workstation with QueueGPSFile, 
because the spooler at the master cannot open the 
file. 
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PRINTING MODE 



You can set the printing mode using 
SetlmageModeGPS . Printing mode controls the way 
the printing device interprets line control 
characters and escape sequences, thereby- 
controlling your ability to pass printer specific 
escape sequences through to the printing device 
with your output stream. See the entry for 
SetlmageModeGPS in Chapter 7, "GPS Routing Switch 
Requests," for more information on printing 
modes . 



SPECIEYINg A PRINTING DEVICE 

You can print to any GPS device by specifying the 
device name when you make your print request. 

If you want to provide a list of printers for the 
user to choose from you can use GetGPSNetList . 
This request returns all printing devices 
accessible from the workstation from which it is 
sent. The number received is limited by the size 
of the buffer you specify. 

If you want to always print to a specified default 
printing device, you can use GetGPSDefaultPr inter 
to find out what printing device the user has 
chosen for his or her default device. 

GetGPSDef aultPrinter is an object module procedure 
and requires that the user has made the following 
entry in his User Configuration file: 

: GPSDefaultPr inter :PrinterName 

where PrinterName is the GPS name assigned to the 
printing device at installation. 
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GPS STATUS AND CONTROT. FUNCTIONS 



STATUS FUNCTIONS 

With the GetGPSStatus request your application can 
request status on any specific GPS device. The 
information returned includes the state of the 
device (for example, paused for font change) , and 
the name and owner of the document currently 
printing . 

With GetGPSDocInfo you can get additional 
information about a specific print request, such 
as the priority of the job, time to print, current 
page printing, and whether or not the job was 
specified to be printed in security mode. 

For a specific device, GetGPSDevHistory returns a 
limited list of completed documents and gives such 
information as the time the job completed. The 
length of this list varies depending on the 
capabilities of the device driver used by the 
device. Typically it lists the last five jobs. 



CONTROLLING THE PRINTING DEVICE 

For most printer control commands, you use the 
SetGPSControl request. With this you can pause 
the printing device temporarily, cancel the 
current job, or pause the device for alignment. 
To restart, use SetGPSRestart . 

I f the device must pause for font or forms 
changes, this is done automatically by GPS. The 
font or form to be used is set with SetGPSParams . 
To restart after an automatic pause, use 
SetGPSRestart . 

You can also delete a queued job from the print 
queue with DeleteGPSJob . 
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There is an example of how to use Generic Print 
System requests on the distribution disk. 
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6 GPAM PROCEDURES 



This chapter gives a detailed description of each 
of the procedures included in the Generic Print 
Access Method (GPAM) library. See Chapter 4, 
"Using the Generic Print Access Method, " for an 
overview and examples of GPAM. 
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Table 6-1 
GPAM PROCEDURE SUMMARY 
(Page 1 of 4) 



GPAMBeginBold 
GPAMBeginBound 

GPAMBeginltalic 

CP AMBeginOver strike 

GP AMBe ginP a ge 

GPAMBeginRaster 
GPAMBeginTransparent 

GP AMBe g inUnder score 
GPAMClose 



Prints all subsequent 
characters as boldface 
text . 

Adjusts proportional text 
generated by an appli- 
cation to conform to the 
limitations of an output 
device . 

Prints all subsequent 
characters as italic text. 

Indicates that all sub- 
sequent text is to be 
over struck with a spec- 
ified character. 

Causes a new physical page 
to begin and defines a 
series of attributes about 
the new page . 

Indicates raster graphics 
output is to begin. 

Indicates that all sub- 
sec[uent output until 
GPAMEndTransparent is 
called is to be passed 
through to the output 
device and is not to be 
processed in any way by 
the output device driver . 

Indicates that all sub- 
sequent text is to be 
underscored . 

Closes the specified GPAM 
data stream. 
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GPAM PROCEDURE SUMMARY 
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GPAMEndBold 

GPAMEndBound 

GPAMEndltalic 

GP AMEndOver s t r ike 
GPAMEndRaster 

GPAMEndTransparent 

GP AMEndUnder s c o r e 
GPAMLineFeed 



GPAMOpen 



GPAMP 1 aceChar acter 



GPAMRelease 



GP AMRep o s i t i on 



Terminates bold printing. 

Terminates bound printing. 

Terminates italic 
printing . 

Terminates overstr iking . 

Terminates raster graphics 
output . 

Terminates transparent 
output . 

Terminates underscoring. 

Causes the output position 
to move vertically down by 
an amount equal to the 
most recent value set by 
GPAMSetSLD . 

Opens a GPAM data stream 
and specifies all document 
level parameters, for ex- 
ample number of copies. 

Places a single character 
on the current line an 
absolute distance from the 
left side of the page. 

Abnormally closes the out- 
put stream in the case of 
error or an unsuccessful 
GPAMClose. 

Causes subsequent output 
to be placed starting at 
the location specified. 
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GPAMSetColor 



GPAMSetFont 



GPAMSetSLD 



Specifies which color 
should be used for all 
subsequent text. 

Specifies the font name, 
its width, and its height. 

Specifies the vertical 
distance to move for each 
subsequent GPAMLineFeed or 
Return (the single line 
distance) . 



GPAMSetTranslateTable Specifies the name of the 

translate table (12 bytes 
or less) to use to map 
internal 8 bit character 
codes into the codes to be 
presented to the output 
device . 

GPAMSetVerticalOf fset Used for subscripts and 

superscripts . 



GPAMWhiteSpace 



GPAMWriteRecord 



Puts a specified amount of 
white space at the current 
position . 

[text and graphics] 

Writes the specified bytes 
to the open byte stream. 



GPAMGrBeginGraphics 



Used to specify the 
beiginning of any series of 
GPAM Graphics routines or 
GPAMWriteRecord routines 
containing CGM- format 

graphics information. 
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GPAMGrCo lor Table Sets the colors to be used 

witb graphics routines . 

GPAMGrEndGraphics Terminates the definition 

of graphics output. 

GPAMGrFillColor Sets the color used by 

GPAMGrPolygon for interior 
fills. 

GPAMGrHatchlndex Sets the hatch pattern 

used by GPAMGrPolygon to 
fill the figure. 

GPAMGr Inter iorStyle Sets the style used by 

GPAMGrPolygon to fill the 
figure . 

GPAMGrLineColor Sets the color used by 

GPAMGrP o lyL ine . 

GPAMGrLineType Sets the line type used by 

GPAMGrPolyline. 

GPAMGrPerimeterColor Sets the color used by 

GPAMGrPolygon to draw the 
polygon perimeter. 

GPAMGrPolygon Draws a closed polygon. 

GPAMGrP olyL ine Draws a sequence of con- 

nected lines. 
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GPAMBeginBo Id 



Object Module Procedure 



GPAMBeginBold (pGPAMWA) : ErcType 



DESCRIPTION 

GPAMBeginBold indicates that all subsequent text 
is to be printed as bold characters . Bold 
printing continues until turned off by 
GPAMEndBold. 

Bold printing can be specified in combination with 
overstriking and/or underscoring. 

You can change the font with GPAMSetFont while 
bold printing is active without resetting 
GPAMBeginBold . 

A call to GPAMBeginBold while bold printing is 
active is ignored by the output device driver . 



PROCEDURAL INTERFACE 
GPAMBeginBold (pGPAMWA) : ErcType 

where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMBeginBound 



Object Module Procedure 



GPAMBeginBound (pGPAMWA, WXLEFT, WXRight, bJustify 
: ErcType 



DESCRIPTION 

GPAMBeginBound and GPAMEndBound enables the device 
driver to make adjustments in received 
proportional text to account for device -specific 
limitations . 

Applications that generate proportional text use 
the Font Service to allocate space for each 
character in a line based on the width information 
foiond in the font database. Some printers have 
width information different from that used by the 
application because of limitations in the 
printer's font options. 

GPAMBeginBound specifies a pair of X-coordinates, 
between which the device driver is rec[uested to 
place all subsequent characters. The third 
parameter specifies the type of justification to 
take place. 

The justification requested by GPAMBeginBound does 
not occur until the matching GPAMEndBound 
operation occurs. 

Bounding operations are intended to bracket a 
string of text produced with GPAMWriteRecord and 
GPAMWhiteSpace . The text specified by the white 
space operations may be adjusted to suit the 
requirements of justification. 

Any operation causing a change in the current 
Y-coordinate immediately causes a GPAMEndBound 
operation . 
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(eontinued) 



PROCEDURAL INTERFACE 

GPAMBeginBound (pGPAMWA, wXLeft, wXRight, 
bJusti fy) : ErcType 

where 



PGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wXLeft 



is the leftmost position (in 
1440ths/inch units) , between 
which microjustification is 
to be applied. 



wXRight 



is the rightmost position (in 
1440ths/inch units) , between 
which microjustification is to 
be applied. 



b Justi fy 



is a byte variable with 4 
possible values: 

0 Left justify the text 
against wXLeft 



Right justify the 
against wXRight 



text 



2 Left and right justi- 
fication between wXLeft 
and WXRight 

3 Center text between 
wXLeft and wXRight 
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GPAMBeginI talic 



Object Module Procedure 



GPAMBeginI talic (pGPAMWA) : ErcType 



DESCRIPTION 

GPAMBeginI talic causes all subsequent text to be 
printed as italic characters. Italic printing 
continues until turned off by GPAMEndltalic . 

Italic printing may be specified in combination 
with bold, overstriking, and/or underscoring. 

Nested calls to GPAMBeginI talic have no defined 
meaning. Thus, a call to GPAMBeginI talic while 
italic printing is already active, is ignored by 
the device driver . 

GPAMSetFont can be used to change the font while 
italic printing is active. 



PROCEDURAL INTEEIFACE 

GPAMBeginI talic (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte work area for use by 
GPAM procedures . 
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GPAMBeginOverstrlke Object Module Procedure 



GPAMBeginOverstrike (pGPAMWA, bBypass, bChar) : 

ErcType 



DESCRIPTION 

GPAMBeginOverstrike indicates that all subsequent 
text is to be overstruck with the specified 
character. Overstriking continues until turned 
off by GPAMEndOver strike. 

You can specify whether or not spaces are to be 
overstruck . 

GPAMBeginOverstrike can be called while 
overstriking is already in progress, which causes 
any new bypass conditions to replace the previous 
ones. The next (third) call to GPAMEndOver strike 
terminates overstriking; it does not revert back 
to the earlier bypass conditions. 

Overstriking can be specified in combination with 
bold and/or underscoring. Note that the bypass 
conditions on overstriking and underscoring are 
applied independently of each other. 

GPAMSetFont may change the font while overstriking 
is active . 

Subscripts and superscripts (created via use of 
GPAMSetVerticalOf fset) are overstruck in the 
baseline position. 

For proportionally spaced text, the overstrike 
character is centered at the same point as the 
overstruck character . 
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GPAMBeginOver str ike 



(continued) 



PROCEDURAL INTERFACE 



GPAMBeginOverstrike (pGPAMWA, bBypass, bChar) : 

ErcType 



where 



pGPAMWA is the memory address of a 

30 0 -byte memory work area for 
use by GPAM procedures . 



bBypass is 0 to indicate overstrike 

all character positions except 
blanks , 

is 1 to indicate overstrike 
all character positions. 



bChar is the character to be used 

for overstriking. A bChar 
value of OOh results in use of 
the printer's default over- 
strike character . 
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GPAMBeginPage 



Object Module Procedure 



GPAMBeginPage (pGPAMWA, pbParams, cbParams) : 
ErcType 

DESCRIPTION 

GPAMBeginPage causes a new physical page to begin 
and defines a series of attributes about the new 
page . 

You must precede your first page of output with 
GPAMBeginPage . 

With GPAMBeginPage you can specify the form name 
to be used for subsequent printing. For devices 
where manual intervention is needed to change the 
form, the output device driver creates a status 
entry indicating that a change to form FormName is 
required, and then pauses to wait for a Resume 
command to be sent via the SetGPSRestart request . 
If no form name is specified, then the current 
form is used. 

GPAMBeginPage also specifies whether the operator 
must align the form. If forms alignment is speci- 
fied, the output device driver prints the page 
contained in the file FormName .Align . 

Alignment pages are single-page GPAM documents and 
can contain any of the GPAM formatting controls 
except for forms name and forms alignment. They 
are the first page of a document. A status entry 
is made indicating that forms alignment is needed. 
The output device driver then pauses until it is 
restarted by SetGPSRestart. If SetGPSRestart 
indiates resume, then the output device driver 
proceeds. If SetGPSControl indicates align 

forms, the output device driver reprints the page 
and pauses again as above . 
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GPAMBeginPage 



(continued) 



When a process requests restarting of a printer at 
a given page number (via SetGPSRestart) , the most 
recent such declarations are used to invoke the 
form name and/or forms alignment routines. Once 
loading of the desired form and/or alignment is 
confirmed, printing begins at the desired page 
number. Alignment pages are not counted as num- 
bered pages for purposes of positioning the 
document during a restart. 



PROCEDURAL INTERFACE 

GPAMBeginPage (pGPAMWA, pbParams, cbParams) : 
ErcType 

where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 

pbParams 

cbParams describes an area containing 

the new parameters to use for 
this page. If cbParams is 0, 
then the parameter settings 
from the previous page are 
used . I f CbParams is 0 and 
this is the first page, the 
defaults listed below are 
used. 

The Params data area has the 
following structure: 
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(continued) 



DESCRIPTION 



0 bSides 1 is 0 to indicate use de- 

fault setting. 

is 1 to indicate print on 
one side. 

is 2 to indicate print on 
both sides . 



1 fStagger 1 is TRUE to indicate that 

the page should be stag- 
gered in the output bin. 



is FALSE to indicate that 
the page should be placed 
in the same position in 
the output bin as the 
previous page (that is, 
not staggered) . This is 
the default. 



2 wBinIn 2 is the number of the in- 

put bin to be used for 
sheet feeder selection. 
A value of 0 indicates 
use the default bin. 
This is the default. 



4 sbFbrmName 13 is the form name to be 

used. If the size is 0, 
then the default form is 
used. The default is to 
use the default form. 
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GPAMBeginPage 



(continued) 



17 fAlign 1 



18 bAspect 1 



19 sbPageNum 13 



is TRUE to indicate oper- 
ator forms alignment is 
needed before printing 
this page. 

is FALSE to indicate that 
operator forms alignment 
is not needed. This is 
the default. 

is 0 to indicate use de- 
fault aspect, which is 
the portrait mode. This 
can be overridden with 
WPgLength and WPgWidth. 

is 1 to indicate use 
landscape aspect (where 
the main axis rions the 
width of the page) . 

is 2 to indicate use 
portrait aspect (where 
the main axis runs the 
length of the page) . 

is the page number of 
this page and is used 
during restart. If the 
size is 0, then this page 
is assigned a number 
equal to its ordinal 
position in the document 
(this is the default) . 
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GPAMBeginPage 



(continued) 



45 bQuality 



46 wPgLength 



48 wPgWidth 



It is recommended that 
processes using strings 
as page numbers should 
explicitly set this value 
for all pages. 

1 is 0 to indicate use de- 
fault setting. 

is 1 to indicate draft 
/data processing quality. 

is 2 to indicate use memo 
quality. 

is 3 to indicate use 
letter cjuality. 

2 is the length of the page 
in 1440ths of an inch. 
Zero is the default and 
means to use the device 
driver ' s default length . 

2 is the width of the page 
in 1440ths of an inch. 
Zero is the default and 
means to use the device 
driver ' s default width . 
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GaPAMBeginTransparent 



Object Module Procedure 



GPAMBeginTransparent (pGPAMWA) : ErcType 



DESCRIPTION 

GPAMBeginTransparent indicates that all subsecjuent 
output is to be passed through to the output 
device and is not to be processed in any way by 
the output device driver . Transparent output is 
turned off with a call to GPAMEndTransparent . 

GPAMWriteRecord should be the only GPAM routine 
called between GPAMBeginTransparent and 
GPAMEndTransparent . 



This routine is intended for advanced 
functions such as sending programs to program- 
mable devices, and may cause the GPAM output 
stream to lose its device independence. 



PROCEDURAL INTERFACE 

GPAMBeginTransparent (pGPAMWA) : ErcType 



NOTE 



where 



pGPAMWA 



is the memory address of a 
30 0 -byte memory work area for 
use by GPAM procedures . 



GPAM Procedures 



6-17 



GPAMBeginUnderscore Object Module Procedure 



GPAMBeginUnderscore (pGPAMWA, bBypass, 

bUnderscore) : ErcType 



DESCRIPTION 

GPAMBeginUnderscore indicates that all subseqpjent 
text is to be underscored. Underscoring continues 
lintil turned off by GPAMEndUnderscore . 

Single or double underscoring can be selected. 

To indicate whether or not spaces are to be 
underscored, one of two bypass conditions can be 
selected. Note that the bypass conditions on 
over striking and underscoring are applied 
independently of each other. 

GPAMBeginUnderscore may be called while 
underscoring is already in progress, which causes 
any new bypass conditions to replace the previous 
ones. The next call to GPAMEndUnderscore termi- 
nates underscoring; it does not revert back to the 
earlier parameter values. 

GPAMSetFont may change the font while underscoring 
is active . 

Subscripts and superscripts (created with 
GPAMSetVerticalOf fset) are underscored in the 
baseline position. 

For proportionally spaced text, ixnderscoring is 
adjusted so as to stay within the horizontal 
boundaries of the text. 
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PROCEDURAL INTEEIFACE 

GPAMBeginUnderscore (pGPAMWA, bBypass, 

bUnderscore) : ErcType 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 

is 0 to indicate underscore 
all character positions except 
blanks . 

is 1 to indicate underscore 
all character positions. 

bUnderscore is 1 to indicate single under- 

scoring. 

is 2 to indicate double under- 
scoring . 
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where 
pGPAMWA 



bBypass 



GPAMClose 



Object Module Procedure 



GPAMClose (pGPAMWA) : ErcType 



DESCRIPTION 

GPAMClose closes the GPAM output stream identified 
by the memory address of the GPAM work area. 
GPAMClose writes any partially filled buffers and 
waits for all write operations to complete. 

In the case of spooled output this means that the 
output has all been successfully spooled to disk; 
it does not indicate that printing or plotting has 
completed . 

After calling GPAMClose the process can reuse the 
GPAM work area and buffer area. If an error 
occurs during GPAMClose, then the output stream is 
closed and a status code is returned. 



PROCEDURAL INTERFACE 
GPAMClose (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMEndBold 



Object Module Procedure 



GPAMEndBold (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMEndBold terminates bold printing. 

PROCEDURAL INTERFACE 
GPAMEndBold (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMEndBound 



Object Module Procedure 



GPAMEndBound (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMEndBound terminates boiand printing, causing 
the justification in the preceding GPAMBeginBound 
operation to be applied. 

PROCEDURAL INTERFACE 
GPAMEndBound (pGPAMWA) 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 
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GPAMEndltalic 



Object Module Procedure 



GPAMEndltalic (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMEndltalic terminates italic printing. 

PROCEDURAL INTERFACE 
GPAMEndltalic (pGPAMWA) 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 
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GPAMEndOver strike 



Object Module Procedure 



GPAMEndOver strike (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMEndOver strike terminates overstriking . 
PROCEDURAL INTERFACE 

GPAMEndOverstrike (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMEndTransparent; Object Module Procedure 



GPAMEndTransparent (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMEndTransparent terminates transparent output . 
PROCEDUEIAL INTERFACE 

GPAMEndTransparent (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures. 
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GEPAMEndUnderscore 



Object Module Procedure 



GPAMEndUnder score (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMEndUnderscore terminates underscoring. 
PROCEDURAL INTERFACE 

GPAMEndUnderscore (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

30 0 -byte memory work area for 
use by GPAM procedures . 
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GSPAMLineFeed 



Object Module Procedure 



GPAMLineFeed (pGPAMWA) : ErcType 



DESCRIPTION 

GPAMLineFeed causes the output position to move 
vertically down by an amount equal to the most 
recent value set by GPAMSetSLD. No horizontal 
movement takes place. 



NOTE 

Return causes both CarriageReturn and 
GPAMLineFeed. It is the preferred method. 

LineFeed is a one-byte control in IBM DCA 
Final Form Text. It has been included here so 
that documents coming in from IBM through a 
gateway process can retain the semantics of 
vertical motion only. 



PROCEDURAL INTERFACE 
GPAMLineFeed (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMOpen 



Object Module Procedure 



GPAMOpen (pGPAMWA, sGPAMWA, pbFileSpec, 

cbFileSpec, pbPassword, cbPassword, 
pBufferArea, sBufferArea, pbParams, 
cbParams) : ErcType 



DESCRIPTION 

GPAMOpen must be the first GPAM procedure called. 

This routine specifies all document level para- 
meters, including the following: 

• identifier of desired device or device 
class 

• number of copies desired 

You can avoid the potential delay that occurs with 
spooled printing when an entire temporary file is 
created before printing begins, by specifying that 
if the printing device is free, you want printing 
or plotting to start immediately. Note that this 
option is acted upon by the spooler and not by the 
output device driver. 



PROCEDURAL INTERFACE 



GPAMOpen (pGPAMWA, sGPAMWA, pbFileSpec, 

cbFileSpec, pbPassword, cbPassword, 
pBufferArea, sBufferArea, pbParams, 
cbParams) : ErcType 
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where 
pGPAMWA 

sGPAMWA 



pbFileSpec 
cbFileSpec 



pbPassword 
cbPassword 



pBuf ferArea 
sBuf ferArea 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 

is 300 (this may change in 
subsequent versions of GPAM 
and GPS) . 



describe a device 
speci f ication . 



or file 



describe a device, volume, 
directory or file password. 



describe a memory area provid- 
ed for exclusive use of GPAM 
procedures . This area must be 
at least 1024 bytes and word- 
aligned. If the buffer is 
greater than 4800 bytes, then 
only the first 480 0 bytes are 
be used . 
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GPAMOpen 



(continued) 



pbParams 

cbParams describe an area containing 

the parameters to use for this 
document. If cbParams is 0, 
then all default parameter 
settings will be used. 

The Params data area has the 
following structure: 



DESCRIPTION 

0 sbDocName 93 



93 sbUserName 31 
124 fSecurity 1 



is the name of the 
document. (This is the 
name that displays in the 
Print Manager . ) A size 
of zero means to use the 
default, which is no 
DocName . 

is the client user name. 
A size of zero means to 
use the default, which is 
no UserName . 

is TRUE to indicate the 
output should be printed 
in security mode. The 
output device driver 
makes a status entry in- 
dicating that a password 
is needed, and then 
pauses . 

is FALSE to indicate the 
output should not be 
printed in security mode. 
This is the default. 
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125 fSupressPage 1 is TRUE to indicate that 

the output device driver 
should not do a form feed 
prior to commencing 
output . 



126 fSuppressBanner 1 



is FALSE to indicate that 
the output device driver 
should do a form feed 
prior to commencing out- 
put . This is the 
default . 

is TRUE to indicate that 
the output device driver 
should not print a banner 
or the notice file. 

is FALSE to indicate that 
the output device driver 
should print a banner and 
the notice file. This is 
the default. 



129 qTimeCreated 4 is the date and time the 

output was created. A 
zero value means to use 
the default, which is the 
current date and time. 
(Date/time formats are 
discussed in the CTOS 
Operating System Manual.) 
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(continued) 



133 qReqOutputStartTime 4 

is the date/time after 
which outputting can 
begin. A zero value 

indicates as soon as 
possible. This is the 
default. (Date/time 
formats are discussed in 
the CTQS Operating System 
Manual . ) 

137 wcCopies 2 is the number of copies 

to be output . This para- 
meter is used only for 
spooled printing. For 
direct printing, only one 
copy of the document is 
produced regardless of 
this parameter ' s value . 
Default is one copy. 

39 wTimeout 2 is the time, in tenths of 

a second, that GPAM will 
wait for a response from 
GPS to a write request. 
OFFFFh indicates no 
timeout. This is the 
default. 



141 fSingleSheet 1 is TRUE to cause pauses 

between pages (single 
sheet feed) . 



is FALSE to indicate that 
continuous feed paper is 
being used. This is the 
default . 
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142 wTimeToPrint 2 is the approximate time 

in minutes for the job to 
print. Default is zero. 

144 bPriority 1 is the queue entry 

priority. (See the CTQS 

Operating System Manual 

for more information.) 
Default is five. 
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GPAMP 1 aceChar acter 



Object Module Procedure 



GPAMP laceChar acter (pGPAMWA, bChar, wPosition) : 

ErcType 



DESCRIPTION 

GPAMP laceChar acter places a single character on 
the current line an absolute distance from the 
left side of the page. 

The same rules about special characters that apply 
to GPAMWriteRecord also apply to 

GPAMP laceChar acter . 



PROCEDURAL INTERFACE 

GPAMP laceChar acter (pGPAMWA, bChar, wPosition) : 

ErcType 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



bChar 



is the character to be output. 



wPosition 



is the position in 1440ths of 
an inch relative to the left 
side of the page where the 
character should be placed. 
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GPAMRelease 



Object Module Procedure 



GPAMRelease (pGPAMWA) : ErcType 



DESCRIPTION 

GPAMRelease abnormally closes the output stream 
identified by the GPAM work area. Unlike 
GPAMClose, GPAMRelease does not write out 
partially full buffers. GPAMRelease should be 
used following an unsuccessful GPAMClose, or 
following a fatal GPS error. 



PROCEDURAL INTERFACE 
GPAMRelease (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMRepo s i t i on 



Object Module Procedure 



GPAMRepositlon (pGPAMWA/ wHorizontal, wVertical) : 
ErcType 



DESCRIPTION 

GPAMRepositlon specifies a starting location for 
subsequent output in 1440ths of an inch relative 
to the left and top edges of the current physical 
page. Allowable values are 0 to 55534 (45.5 
inches) . A value of OFFFFh indicates use the 
current position. 

GPAMRepositlon is generally used only to place a 
figure on the page before a call to 
GPAMBeglnGraphics , or after a sequence of graphics 
calls. 

When output is repositioned to a point that is not 
flush with the left edge of the physical page, 
subsequent lines (caused by Return, 

CarrlageReturn, FormFeed, or a call to 
GPAMBeginPage) start at the indented position. 
Thus GPAMRepositlon has the effect of estab- 
lishing a new left margin. 
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GPAMReposltlon 



(continued) 



GPAM Reposition 



Graphics 
Area 



Page 



Figure 6-1. Repositioning 



Repositioning is only allowed within the current 
physical page. The output device driver may cause 
a new page to begin when the selected device 
cannot accommodate the amount of output provided 
on a single page . 

Not all device drivers support repositioning. 
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GPAMReposi t i on 



(continued) 



PROCEDURAL INTERFACE 

GPAMReposition (pGPAMWA, wHorizontal, wVertical) 
ErcType 

where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wHorizontal 



is the location to which re- 
positioning will be done. It 
is specified in 1440ths of an 
inch, relative to the left 
edge of the current physical 
page. Value OFFFFh indicates 
use the current horizontal 
position . 



wVertical 



is the location to which re- 
positioning will be done. It 
is specified in 1440ths of an 
inch, relative to the top edge 
of the current physical page. 
Value OFFFFh indicates use the 
current vertical position. 
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GPAMSetColor 



Object Module Procedure 



GPAMSetColor (pGPAMWA, wColor) : ErcType 
DESCRIPTION 

GPAMSetColor specifies which color should be used 



operator action to change colors, the output 
device driver makes a status entry indicating that 
a change to color wColor is needed and then pauses 
to wait for a restart command given with 
GPSRestart . 



PROCEDURAL INTERFACE 

GPAMSetColor (pGPAMWA, wColor) : ErcType 



for all subsequent text. 



On devices requiring 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wColor 



is the number of the color to 
be used for subsequent output . 
(See GPAMGrCo lor Table for 
numbers . ) 
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GPAMSetFont 



Object Module Procedure 



GPAMSetFont (pGPAMWA, pbFontName, cbFontName, 
wWidth, wHeight) : ErcType 



DESCRIPTION 

GPAMSetFont specifies the font identification (40 
bytes or less), its width, and its height. 
Because the font identification and width are 
separately specified, it is possible to use the 
same font at different pitches. 

On devices recjuiring manual changing of the font, 
the output device driver makes a status entry 
indicating that a change to font FontName is 
required and then pauses to wait for a Restart 
command given with SetGPSRestart . 

Font width and height are specified in 1440 ths of 
an inch . 

(See the Printing Guide for more information on 
fonts . ) 



PROCEDURAL INTERFACE 

GPAMSetFont (pGPAMWA, pbFontName, cbFontName, 
WWidth, wHeight) : ErcType 

where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMBetFont 



(continued) 



pbFontName 

cbFontName is the name of the font to be 

used (maximum is 40 bytes) . 



wWidth 



is the width of the font. 
This parameter is used for 
fixed pitch fonts only. A 
value of 0 selects the default 
width for the named font. 



wHeight 



is the height of the font. A 
value of 0 selects the default 
height for the named font . 
The height of the font is its 
point size. 
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GPAMSetSLD 



Object Module Procedure 



GPAMSetSLD (pGPAMWA, wSLDDistance) : ErcType 
DESCRIPTION 

GPAMSetSLD specifies the vertical distance to move 
for each subsequent GPAMLineFeed or Return (the 
single line distance) . The value is specified in 
1440ths of an inch. The default is determined by 
the device driver. 

If the value specified is not supported by the 
output device, then the next smaller value that is 
supported is used. If a smaller value is not 
supported, then the next larger value that is 
supported is used. 

When the first character of output is provided for 
a new line, the most recent GPAMSetSLD value is 
applied and cannot be changed for that line, until 
the next GPAMLineFeed, FormFeed, or Return. 



PROCEDURAL INTERFACE 

GPAMSetSLD (pGPAMWA, wSLDDistance) : ErcType 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wSLDDistance 



is the vertical distance in 
1440ths of an inch that will 
be used for subsequent 
GPAMLineFeed or Return 

operations . 
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G3PAMSetVerticalOf fset Object Module Procedure 



GPAMSetVerticalOf fset (pGPAMWA, intLevel) : 

ErcType 



DESCRIPTION 



GPAMSetVerticalOf fset is used for subscripts and 
superscripts . 

A positive intLevel value causes subsecjuent 
characters to be superscripted by moving the 
output position vertically up a fraction of the 
single line distance (specified via GPAMSetSLD) . 
Negative values work similarly for subscripting. 

Values of intLevel greater than 1 or less than -1 
have the effect of nested superscripts and 
subscripts. For example, an intLevel value of 1 
causes normal super scripting, while a value of 2 
has the effect of nested superscripts ("a 
superscripted superscript") . 
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GPAMSetVerticalO f f set 



(continued) 



PROCEDURAL INTERFACE 

GPAMSetVerticalO ff set (pGPAMWA, intLevel) : 

ErcType 

where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 

intLevel is a 16-bit signed integer. 

Allowed values are negative 8 
through positive 8, with 0 
indicating a return to the 
baseline position. Positive 
values indicate superscripting 
(that is, the printing posi- 
tion will be moved upward) . 
Negative values indicate 
subscripting . 

If a given output device does 
not support the number of 
levels specified, then the 
next level closer to the 
baseline position is selected. 
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GPAMWlilt:eSpace 



Object Module Procedure; 



GPAMWhiteSpace (pGPAMWA, wWidth) : ErcType 



DESCRIPTION 

GPAMWhiteSpace puts wWidtti 1440 ths of an inch of 
white space at the current position, and advances 
the current position by wWidth. If underscore or 
overstrike are activated, they are applied to the 
white space . 



PROCEDURAL INTERFACE 

GPAMWhiteSpace (pGPAMWA, wWidth) : ErcType 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures. 



wWidth 



is the length of the white 
space in 1440ths of an inch. 
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G3PAMWriteRecord 



Object Module Procedure 



GPAMWriteRecord (pGPA^4WA, pb, cb, pcbRet) : 
ErcType 



DESCRIPTION 

GPAMWriteRecord writes the specified bytes to the 
open byte stream identified by the memory address 
of the GPAMWA. 

GPAMWriteRecord is similar to WriteBSRecord with 
the exception that it precedes all application- 
generated data with a length field. This ensures 
that no application- generated data will be 
mistaken for a GPAM escape sequence. 

The data written to the output stream may contain 
any of the possible 256 character codes. 

The following single character codes cause special 
action whenever they are present in the text; they 
have no action within graphics data: 

• CarriageReturn (ODh) causes the output 
pointer to move to the left most position 
on the current 1 ine . 

Note that this position cannot be flush 
with the left edge of the physical page 
if GPAMReposition has been used to 
establish a different left margin. 
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GPAMWr i teRecor d 



Object Module Procedure 



• LineFeed (OAh) acts the same as 
CarriageReturn followed by GPAMLineFeed . 
This is the preferred method of starting 
a new line. 

• FormFeed (OCh) acts much like a call to 
GPAMBeginPage but does not alter any of 
the current page attribute settings . In 
addition, the current printer state is 
not replicated for restart purposes. 
Thus, FormFeed should not be used unless 
default printer conditions are acceptable 
during restart. 

Note that use of some codes within a text area, if 
not translated to graphic characters by the 
translate table in the output device driver, can 
result in a variety of actions when sent to the 
output device. For example, VerticalTab (OBh) 
and the HorizontalTab (09h) make some printers 
space vertically or horizontally on the page. 
GPAM does not prevent such codes from being sent 
to the device driver, but the results are not 
guaranteed by GPAM and may be device-specific. 
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GPAMWr iteRecor d 



Object Module Procedure 



PROCEDURAL INTERFACE 



GPAMWr iteRecord (pGPAMWA, pb, cb, pcbRet) 

ErcType 



where 



pGPAMWA 



pb 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 

is the memory address of the 
data to be written. 



cb 



pcbRet 



is the count of bytes to be 
written. The maximum is 508 
bytes . 

is the memory address of the 
word to which the count of 
data bytes successfully writ- 
ten is returned. 
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CTAMGrBeginGraphics Object Module Procedure 



GPAMGrBeginGraphics (pGPAMWA, wWidth, wHeight, 

fClear) : ErcType 



DESCRIPTION 

GPAMGrBeginGraphics indicates that graphics out- 
put is to begin. Subsequently, all GPAM routines 
called before GPAMGrEndGraphics must be either 
graphics routines (GPAMGr routines) or 
GPAMWriteRecord routines containing VDM- format 
graphics information. 

The application can specify graphic output by 
using GPAMWriteRecord to write out the image of a 
VDM file (which may have been created using calls 
to the WriteVDM routine in Graphics . Lib) , or by 
calling other GPAMGr routines. 

GPAMGrBeginGraphics also specifies the width and 
height of the graphics area, thus allowing the 
output device driver to automatically scale the 
graphics . 

The picture is placed with the upper -left corner 
at the current print position. Thus, in many 
cases GPAMReposition should be used before calling 
GPAMGrBeginGraphics to establish the desired 
starting location. 

Any currently active formatting controls (for 
example. Bold) are not applied to the graphics. 

Pictures cannot cross page boundaries . 
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GPAMGrBeginGraphics 



(continued) 



PROCEDURAL INTEEIFACE 



GPAMGrBeginGraphics (pGPAMWA, wWidth, wHeight, 

fClear) : ErcType 

where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wWidth 



is the width of the picture in 
1440ths of an inch. Values up 
to 65535 (45.5 inches) can be 
specified. A value of zero 
means to use the device 
driver's default page width. 



wHeight 



is the height of the picture 
in 1440ths of an inch. Values 
up to 65535 (45.5 inches) can 
be specified. A value of zero 
means to use the device 
driver's default page height. 



fClear 



is true if the area specified 
by wWidth and wHeight should 
be cleared of all information 
before the picture is printed. 
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GPAMGrColorTable 



Object Module Procedure 



GPAMGrColorTable (pGPAMWA, windex, pbColors, 
cbColors) : ErcType 



DESCRIPTION 

GPAMGrColorTable sets tlie color palette to the 
values in the passed color array beginning at the 
passed index value (for example, if windex 115 is 
specified, then the color values from 115 through 
255 can be specified) . For each index location, 
colors are expressed as consecutive integer 
intensities of red, green and blue, where 0 is 0% 
and 1000 is 100%. You can define .1% increments. 



PROCEDURAL INTERFACE 

GPAMGrColorTable (pGPAMWA, windex, pbColors, 
CbColors) : ErcType 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



windex 



is the palette index number of 
the first palette to change. 
Allowed values are 0 to 255. 



pwColors 
cwColors 



describe the array of consec- 
utive Red, Green and Blue 
values to place in the color 
palette . 
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GPAMGrColorTable 



(Continued) 



wRed wGreen wBlue 



0 


1000 


0 


0 


= Red 


1 


0 


1000 


0 


= Green 


2 


0 


0 


1000 


= Blue 


3 


1000 


1000 


1000 


= White 


4 


0 


0 


0 


= Black 



t89-0t3 



Figure 6-2. Color Array 
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GPAMGrEndGrapliics 



Object Module Procedure 



GPAMGrEndGraphics (pGPAMWA) : ErcType 
DESCRIPTION 

GPAMGrEndGraphics terminates the definition of 
graphics output . 

PROCEDURAL INTERFACE 

GPAMGrEndGraphics (pGPAMWA) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 
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GPAMGr F i 1 1 Co 1 or 



Object Module Procedure 



GPAMGrFillColor (pGPAMWA, wColor) : ErcType 



DESCRIPTION 



GPAMGrFillColor sets the color 
GPAMGrPolygon for Interior fills. 



used 



by 



PROCEDURAL INTERFACE 



GPAMGrFillColor (pGPAMWA, wColor) : ErcType 



where 



pGPAMWA 



is the memory address of a 
30 0 -byte memory work area for 
use by GPAM procedures . 



wColor 



is the color index number to 
use for filling. Allowed 
values are 0 to 255. 
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GPAMGrHatchlndex 



Object Module Procedure 



GPAMGrHatchlndex (pGPAMWA, wHatchlndex) : ErcType 



DESCRIPTION 

GPAMGrHatchlndex sets the hatch pattern used by 
GPAMGrPolygon to fill the figure. This value is 
used as an index into a set of predefined hatch 
types. It is significant only when 

GPAMInteriorStyle sets the style to hatch. 



PROCEDURAL INTERFACE 

GPAMGrHatchlndex (pGPAMWA, wHatchlndex) : ErcType 
where 

pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 

wHatchlndex is the index into a list of 

hatch types to use for polygon 
filling. Allowed values are 0 
to 6. 



Crosshatch Definition 

1 = Narrow Diagonal 

2 = *** Not Available *** 

3 = Wide Diagonal 

4 = Narrow Crosshatch 

5 = *** Not Available *** 

6 = Wide Crosshatch 
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GJPT^MGrlnteriorStyle 



Object Module Procedure 



GPAMGrlnteriorStyle (pGPAMWA, wInteriorStyle, 

fPerimeterVis) : ErcType 

DESCRIPTION 

GPAMGrlnteriorStyle sets the style used by 
GPAMGrPolygon to fill the figure. The 
wInteriorStyle parameter is used as an index into 
a set of predefined interior styles. 
fPerimeterVis determines if the polygon perimeter 
is to be drawn or not . 

PROCEDURAL INTERFACE 

GPAMGrlnteriorStyle (pGPAMWA, wInteriorStyle, 

fPerimeterVis) : ErcType 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 

is the index into a list of 
interior styles to use for 
polygon filling. Allowed 
values are 0 to 3 . 

is TRUE if the perimeter is to 
be visible and FALSE other- 
wise . 

Interior Style Definition 

0 = Hollow 

1 = Solid 

2 = Hatch 

3 = *** Not Available *** 



where 
pGPAMWA 

wInteriorStyle 
fPerimeterVis 
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GPAMGrLineColor 



Object Module Procedure 



GPAMGrLineColor (pGPAMWA, wColor) : ErcType 



DESCRIPTION 

GPAMGrLineColor sets the color used by 
GPAMGrPolyLine . 



PROCEDURAL INTERFACE 

GPAMGrLineColor (pGPAMWA, wColor) : ErcType 
where 



pGPAMWA is the memory address of a 

300 -byte memory work area for 
use by GPAM procedures . 

wColor is the color index number to 

use for line drawing. Allowed 
values are 0 to 255 . 
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GPAMGrLineType 



Object Module Procedure 



GPAMGrLineType (pGPAMWA, wLineType) : ErcType 



DESCRIPTION 

GPAMGrLineType sets the line type used by 
GPAMGrPolyline . This value is used as an index 
into a set of predefined line types. 



PROCEDURAL INTERFACE 

GPAMGrLineType (pGPAMWA, wLineType) : ErcType 
where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wLineType 



is the index into a list of 
line types to use for line 
drawing. Allowed values are 0 
to 8. 



Line Type Definition 

0 = Solid 

1 = Dashed 

2 = Dotted 

3 = Dash Dot 

4 = * Not Available * 

5 = Line Dash Dash 
5 = Line Dash 

7 = Line Blank 

8 = Line Blank Blank 
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GaPAMGrPerimeterColor Object Module Procedure 



GPAMGrPerimeterColor (pGPAMWA, wColor) : ErcType 



DESCRIPTION 

GPAMGrPerimeterColor sets the color used by 
GPAMGrPolygon to draw the polygon perimeter. 



PROCEDURAL INTERFACE 



GPAMGrPerimeterColor (pGPAMWA, wColor) : ErcType 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



wColor 



is the color index number to 
use for drawing the polygon 
perimeter. Allowed values are 
0 to 255. 
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GPAMGr P o ly gon 



Object Module Procedure 



GPAMGrPolygon (pGPAMWA, pbPoints, cbPoints) 
ErcType 



DESCRIPTION 

GPAMGrPolygon draws a closed polygon. The polygon 
is described as a series of points in an array 
with consecutive points connected, and the last 
point connected to the first. The 
GPAMGr Inter iorStyle routine sets whether or not 
the polygon will be outlined, and the 
GPAMPerimeterColor routine defines the outline 
color. The values set in GPAMGrFillColor , 

GPAMGr Inter iorStyle and GPAMGrHatchlndex determine 
the interior contents of the polygon. 



Open-1 
Close-5 • 



• 2 



A- . 



• 3 



Figure 6-3. A Square Has Five Points 
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GPAMGrPo ly gon 



Object Module Procedure 



PROCEDURAL INTERFACE 

GPAMGrPolygon (pGPAMWA, pbPoints, cbPoints) 
ErcType 

where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



pbPoints 
cbPoints 



describe the array of points 
used to draw the lines. The 
limit is 8191 points (32764 
bytes) . 



0, 32k 



32k. 32k 
Max, Max 



0. 0 



32k. 0 



Figure 6-4. Maximum X and Y Values 
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GPAMGrPolyLine 



Object Module Procedure 



GPAMGrPolyLine (pGPAMWA, pbPoints, cbPoints) : 
ErcType 



DESCRIPTION 

GPAMGrPolyLine draws a secjuence of connected 
lines, described as a series of points in an 
array. The values set in GPAMGrLineColor and 
GPAMGrLineType determine the color and type of the 
line . 



PROCEDURAL INTERFACE 

GPAMGrPolyLine (pGPAMWA, pbPoints, cbPoints) : 
ErcType 



where 



pGPAMWA 



is the memory address of a 
300 -byte memory work area for 
use by GPAM procedures . 



pbPoints 
cbPoints 



describe the array of points 
used to draw the lines. The 
limit is 8191 points (32764 
bytes) . 
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7 GPS ROUTING SWITCH REQUESTS 



This chapter gives a detailed description of each 
of the requests you can make of the Generic Print 
System routing switch. See Chapter 5, "Using GPS 
Requests" for an overview and examples. 



GPS Routing Switch Requests 7-1 



Table 7-1 



SUMVIARY OF ROUTING SWITCH REQUESTS 
(Page 1 of 2) 



CloseGPSFile 



Terminates an output ses- 
sion, closes the open device 
driver and releases associ- 
ated hardware resources . 



DeleteGPSJob 



Causes a document queued at 
a device to be deleted. 



GetGPSDevHi story- 



Provides a list of documents 
that have been printed by a 
particular device, indicates 
when the printing started 
and finished, and the status 
of the document upon 
termination . 



GetGPSDeviceConfig 



Returns configuration infor- 
mation about a particular 
device . 



GetGPSDocInfo 



Used to query GPS about the 
status of documents that are 
printing or are waiting to 
be printed at a selected 
device . 



GetGPSNetList 



Returns a list of all GPS 
output devices accessible 
from the workstation running 
the application. 



GetGpsSplVolStatus 



Returns the number of 
512 -byte pages remaining on 
the spooling volume. 
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Table 7-1 



SUMMARY OF ROUTING SWITCH REQUESTS 
(Page 2 of 2) 



GetGPSStatus request Returns 

for a 
device . 



status information 
particular output 



OpenGPSFile 



ProvideGPSPassword 



QueueGPSFile 



SetGPSControl 



Opens a 
output . 



GPS device for 



Provides a password so that 
printing of a password pro- 
tected document, printed in 
security mode can start . 

Allows an application to add 
a document file to a spooled 
generic device ' s queue . 

Provides the mechanism for 
applications to send control 
commands to generic print 
devices . 



SetGPSParams 



SetGPSRestart 



SetlmageModeGPS 



Provides information to the 
GPS system about a job that 
has just been opened with 
the OpenGPSFile request. 

Provides the mechanism for 
applications to send restart 
control commands to generic 
output devices that have 
previously been paused. 

Sets normal, image, or bi- 
nary mode for a GPS byte 
stream . 



WriteGPSFile 



Transfers a number of bytes 
from memory to the printer . 
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CloseGEPSFile 



Request 



CloseGPSFile (jh) : ErcType 



DESCRIPTION 

The CloseGPSFile request terminates an output 
session, closes the open device driver and re- 
leases associated hardware resources . 

Note that if your application is also using GPAM 
routines, you do not need to use this request 
since GPAM does it for you. 



PROCEDURAL INTERFACE 

CloseGPSFile (jh) : ErcType 
where 

jh is a job handle returned from an OpenGPSFile 
operation. 
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CloseGPSFile 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntlnfo 


1 


2 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


0 


3 


nRespPbCb 


1 


0 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


80 3Bh 


12 




2 





G3PS Routing Switch Requests 7-5 



DeleteGPSJob 



Request 



DeleteGPSJob (pbDeviceName, cbDeviceName, 

pbD o cumen tName , cbD o cumen tName ) 
ErcType 



DESCRIPTION 

The DeleteGPSJob request causes a document queued 
at a device to be deleted. 



PROCEDURAL INTERFACE 



DeleteGPSJob (pbDeviceName, cbDeviceName, 

pbDocumentName , cbDocumentName) 
ErcType 

where 



pbDeviceName 
CbDeviceName 



are a pb/cb pair pointing to the 
device name . 



pbD o cumen tName 
cbD o cumen tName 



are a pb/cb pair that point to a 
string which identifies a 
document . 
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DeleteGPSJob 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntInf o 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


2 


3 


nRespPbCb 


1 


0 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


803Dh 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDeviceName 


2 




26 


pbD o cumen tName 


4 




30 


cbDocumentName 


2 
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GetGPSDevHistory 



Request 



CJetGpsDevHistory (pbDeviceName, cbDeviceName, 

pBufferRet, sBufferMax) : ErcType 



DESCRIPTION 

The GetGPSDevHistory provides a list of which 
documents have been printed by a particular 
device, when the printing started and finished, 
and the status of the document upon termination. 
The number of documents in this list is finite and 
defined by the device driver when it is built. 

Documents must be closed before they become 
history. GetGPSDevHistory does not list jobs 
currently open . 



PROCEDURAL INTERFACE 



GetC^sDevHi story (pbDeviceName, cbDeviceName, 

pBufferRet, sBufferMax) : ErcType 

where 

pbDev i ceName 

cbDeviceName are a pb/cb pair pointing to the 



device name . 



pBufferRet 
sBufferMax 



are a pb/cb pair pointing to a 
buffer area in which the device 
history will be returned. The 
format of this data structure is 
defined in Table 7-5. 
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GetGPSDevHistory 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntInf o 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


1 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


803Fh 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDeviceName 


2 




26 


pBuf ferRet 


4 




30 


sBuf ferMax 


2 
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GetGPSDeviceConflg 



Request 



GetGPSDeviceConflg (pbDeviceName, cbDeviceName , 

pBufferRet, sBufferMax) : 
ErcType 



DESCRIPTION 

The GetGPSDeviceConflg request returns config- 
uration information about a particular device. 



PROCEDURAL INTERFACE 



GetGPSDeviceConflg (pbDevlceName, cbDeviceName, 

pBufferRet, sBufferMax) : 
ErcType 

where 



pbDe V 1 c eName 
CbDeviceName 



are a pb/cb pair pointing to the 
device name . 



pBufferRet is the memory address of the buffer 

into which to place the configura- 
tion Information (see Table 7-4) . 



sBufferMax is the size of the buffer. If the 

buffer is too small, the configura- 
tion information is truncated. 
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GetGPSDeviceConflg 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntlnfo 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


1 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8040h 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDevi ceName 


2 




26 


pBuf ferRet 


4 




30 


sBuf ferMax 


2 
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GetGPSDocInfo 



Request 



GetGpsDocInfo (qeh, pbDeviceName , cbDeviceName, 
pBufferRet, sBufferMax, 
psBufferRet, pQehRet, 
pQehNextRet) : ErcType 

DESCRIPTION 

The GetGPSDocInfo request is used to query GPS 
about the status of documents that are printing, 
or are waiting to be printed at a selected device. 

If no more entries exist for the selected device, 
this request returns the status message 
ercRsEndOf Queue . 

If the queue is not empty, status messages are 
returned directly from the device. 

For direct print devices, only one entry can be 
returned. 

PROCEDURAL INTERFACE 

GetGpsDocInfo (qeh, pbDeviceName, cbDeviceName , 
pBufferRet, sBufferMax, 
psBufferRet, pQehRet, pQehNextRet) : 
ErcType 

where 

qeh is the 32 -bit queue entry handle 

returned from a previous 
GetGPSDocInfo operation. A 0 
indicates the first entry in the 
queue . 

pbDeviceName 

CbDeviceName are a pb/cb pair pointing to the 

device name . 
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GetGPSDocInfo 



(continued) 



pBuf ferRet 

sBufferMax are a pb/cb pair pointing to a 

memory area into which the 
document information will be 
returned. The format of this 
information is defined in Table 
7-7, which appears at the end of 
this chapter . 



psBuf ferRet is a pointer to a word into 

which the count of bytes return- 
ed will be placed. 

pQehRet is a pointer to a 4-byte memory 

area where the c[ueue entry 
handle for this entry is return- 
ed. 



pQehNextRet is a pointer to a 4-byte memory 

area where the next cjueue entry 
handle is returned. 
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GetGPSDocIn f o 



(continued) 



REQUEST BLOCK 



Offset 

0 
1 
2 
3 
4 
6 
8 
10 

12 

16 
18 



Field 

sCntlnfo 

RtCode 

nReqPbCb 

nRespPbCb 

userNum 

exchResp 

ercRet 

rqCode 

qeh 

reservedS 
reserved4 



Size 
(bytes) 

1 
1 
1 
1 
2 
2 
2 
2 



Contents 

8 
0 
1 
4 



8041h 



20 pbDevlceName 4 
24 cbDeviceName 2 



26 
30 



pBuf ferRet 
sBuf ferMax 



32 
36 



psBuf ferRet 
ssBuf ferRet 



38 
42 



pQehRet 
sQehRet 



44 
48 



pQehNextRet 
sQehNextRet 
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GetGPSNetList 



Request 



GetGPSNetList (iDevice, pBufferRet, sBufferMax, 
psBuf ferRet) : ErcType 



DESCRIPTION 

The GetGPSNetList recjuest is to be used by 
application programs to interrogate the routing 
switch for a list of all GPS output devices 
accessible from the workstation running the 
application . 

Because the number of devices accessible can be 
large, this request is designed to be called 
several times in sequence so as to allow receipt 
of a complete net list when the return buffer is 
not large enough to contain the entire list. 

If iDevice is set to 0, the buffer will receive a 
concatenation of two data structures (described in 
Tables 7-2 and 7-3) , up to the maximum buffer size 
as set by sBufferMax. This form provides the 
total number of devices available to the routing 
switch . 

If iDevice is set to n <> 0, then the buffer will 
receive a data structure in the form of Table 1-2. 
starting with device n and repeated for device 
n+1, n+2, up to the maximum allocated space 

or until the end of the net list, whichever is 
less . 
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GetGPSNetList (continued) 



PROCEDURAL INTERFACE 

GetGPSNetList (iDevice, pBufferRet, sBufferMax, 
psBuf ferRet) : ErcType 



where 



iDevice is a word defining the index of the 

first device to be returned in the 
buffer defined below. 



pBuf ferRet is the memory address of the buffer 

into which to place the configura- 
tion information (see Tables 7-2 
and 7-3) . 

sBufferMax is the size of the buffer. If the 

buffer is too small, the configura- 
tion information is trxoncated. 



psBufferRet points to a word into which the 
count of bytes returned is placed. 
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GetGPSNetList 



(continued) 



REQUEST BLOCK 



Size 

Offset Field (bytes) Contents 



0 


sCntlnfo 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


0 


3 


nRespPbCb 


1 


2 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8042h 


12 


iDevice 


2 




14 


reservedl 


2 




16 


reserved2 


2 




18 


reservedS 


2 





20 pBufferRet 4 

24 sBufferMax 2 

26 psBufferRet 4 

30 ssBufferRet 2 2 
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GetGPSSp IVo 1 status 



Request 



GetGpsSplVol Status (pbDeviceName, cbDeviceName, 

pCountRet) : ErcType 



DESCRIPTION 

The GetGpsSplVolStatus request is used by the 
client to interrogate the C^sSpooler as to the 
number of 51 2 -byte pages remaining on the spooling 
volume . 



PROCEDURAL INTERFACE 



GetGpsSplVolStatus (pbDeviceName, cbDeviceName, 

pCountRet) : ErcType 



pbDeviceName 

CbDeviceName are a pb/cb pair pointing to the 
device name. 



where 



pCountRet 



is a pointer to a double word in 
memory which will receive the count 
of free 512-byte pages on the 
volume used by the spooler . 
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GetGPSSplVo 1 status 



(continued) 



REQUEST BLOCK 



Size 

Offset Field (bytes) Contents 



0 


sCntInf o 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


1 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8044h 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDeviceName 


2 




26 


pCountRet 


4 




30 


sCountRet 


2 


4 
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GetGPSStatus 



Recjuest 



GetGPSStatus (pbDeviceName, cbDeviceName, 

pStatusRet, sStatusMax) : ErcType 

DESCRIPTION 

The GetGPSStatus request is to be used by 
application programs to interrogate the routing 
switch for information regarding the status of a 
particular output device. This request does not 
use the Job handle convention of WriteGPSFile or 
CloseGPSFile, since it is possible and desirable 
to be able to get the status of a device, 
independent of whether a job is open on that 
device . 

PROCEDURAL INTERFACE 

GetGPSStatus (pbDeviceName, cbDeviceName, 

pStatusRet, sStatusMax) : ErcType 



pbDev i ceName 

CbDeviceName describe a character string of the 



where 



form [devname] , where devname is an 
alphanumeric string of up to 12 
characters . 



pStatusRet 



is the memory address of the buffer 
into which to place the device- 
status information. The format of 
this information is defined in 
Table 7-8. 



sStatusMax 



is the size of the buffer. If the 
buffer is too small, the configura- 
tion information is truncated. 
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GetGPSStatus 



(continued) 



REQUEST BLOCK 



Size 



Of f sel" 


Field 






0 


sCntlnf o 


1 


8 


1 




^ 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


1 


4 


user Nun 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8045h 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDev i ceName 


2 




26 


pStatusRet 


4 




30 


sStatusMax 


2 





GPS Routing Switch Requests 7-21 



OpenGEPSFile 



Request 



OpenGPSFile (pJhRet, pbDeviceName, cbDeviceName, 
pbPassword, cbPassword) : ErcType 

DESCRIPTION 

The OpenGPSFile procedure opens a GPS device for 
output. The job handle returned by OpenGPSFile is 
used to refer to the job in subsequent operations 
such as WriteGPSFile and CloseGPSFile . In the 
case of direct output, the device driver reserves 
the required hardware resources at this time and 
establishes an interrupt handler for the device. 

Note that if your application is also using GPAM 
routines, you do not need to use this request, 
since GPAM does it for you. 

OpenGPSFile opens a device only. Use 
OpenByteStream to open a disk file for printing. 

PROCEDURAL INTERFACE 

OpenGPSFile (pJhRet, pbDeviceName, cbDeviceName, 
pbPassword, cbPassword) : ErcType 



pbDeviceName 

CbDeviceName describe a character string of the 



where 



pJhRet 



is the memory address of a word to 
which the job handle is returned. 



form [devname] , where devname is an 
alphanumeric string of up to 12 
characters . 



pbPassword 
cbPassword 



describe a device, volume, direc- 
tory or file password. 
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OpenGPSFile 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntlnfo 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


2 


3 


nRe spPbCb 


1 


1 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8048h 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDevi ceName 


2 




26 


pbPassword 


4 




30 


cbPassword 


2 




32 


pJhRet 


4 




36 


sJhMax 


2 


2 
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ProvideCaPSPassword 



Request 



ProvideGPSPassword (pbDeviceName, cbDeviceName , 

pbPassword, cbPassword) : 
ErcType 



DESCRIPTION 

If a document was submitted to GPS in security- 
mode, (see f Security variable in job parameters 
data structure. Table 7-10) , a password is 
required before the spooler can access and print 
it . When the document is ready to be printed, the 
GPS system will pause and require the user to 
provide the proper password via the 
ProvideGPSPassword request . 



PROCEDURAL INTERFACE 

ProvideGPSPassword (pbDeviceName, cbDeviceName, 

pbPassword, cbPassword) : 
ErcType 



describe a character string of the 
form [devname] , where devname is an 
alphanxomeric string of up to 12 
characters . 

describe a device, volijme, direc- 
tory or file password. 



where 



pbDev i ceName 
CbDeviceName 



pbPassword 
cbPassword 
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ProvideGPSPassword 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCnt In f o 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


2 


3 


nRespPbCb 


1 


0 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8049h 


12 


reservedl 


2 




14 


reserved2 


2 




16 


reservedS 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDev i ceName 


2 




26 


pbPassword 


4 




30 


cbPassword 


2 
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QueueGPSFile 



Rec[uest 



QueueGPSFile (pbFileName, cbFileName, 

pbDeviceName, cbDeviceName, fDelete, 
pJobParameters, sJobParameters) : 
ErcType 

DESCRIPTION 

The QueueGPSFile procedure allows an application 
to add a document file to a spooled generic 
device ' s queue . 

This request is provided to eliminate the overhead 
of copying the document from the user's file to 
another file that is created for temporary use by 
the GPS spooler . This is not a ByteStream type 
operation, and has two major restrictions: 

1. The generic output device referenced by 
the request must be a spooled device. 

2. The specified file must be accessible by 
the spooler . Note that this is not 
always possible because the file may be 
on a local file system, while the 
spooler may be on a master, another 
cluster workstation, or a remote node, 
and therefore cannot access the file. 

Note that if your application is also using GPAM 
routines , you do not need to use this request 
since GPAM does it for you. 

This request is very useful with very large 
documents. The request points to the file itself, 
instead of making a temporary copy of the file. 
For average-sized files, use WriteGPSFile . 
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QueueGPSFlle 



Request 



PROCEDUEIAL INTERFACE 



QueueGPSFlle (pbFlleName, cbFlleName, 

pbDevlceName, cbDeviceName, fDelete, 
pJobParameters, sJobParameters) : 
ErcType 



where 



pbFlleName 

cbFlleName Is the name of a file containing 

document data that Is to be added 
to the queue of an output device 
for subsequent output . 



pbDevlceName 

cbDevlceName Is the device name for the GPS 

output device that the document 
file Is to be output upon. 



fDelete Is set to TRUE if this user- 

de fined file is to be deleted by 
the GPS after it has been output. 



pJobParameters 

sJobParameters define a buffer containing a data 
structure which specifies that 
various control and information 
parameters are to be associated 
with this document. This data 
structure is defined in 
Table 7-9. 
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QueueGPSFile 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(byt( 


0 


snni" Tri "fa 


1 


1 


RtCode 


1 


2 


nReqPbCb 


1 


3 


nRespPbCb 


1 


ft 


u.seT"Nuiii 




6 


exchResp 


2 


8 


ercRet 


2 


10 


rqCode 


2 


12 


fDelete 


1 


13 


reserved 


1 


14 


reserved2 


2 


16 


reserved3 


2 


18 


reserved4 


2 


20 


pbDe V 1 ceName 


4 


24 


cbDeviceName 


2 


26 


pbFileName 


4 


30 


cbFileName 


2 


32 


p J obPar ameter s 


4 


36 


sJobParameters 


2 



Contents 

8 
0 
3 
0 



804Ah 
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SetG3PSContr o 1 



Request 



SetGPSControl (bCommand, bSubCommand, 

pbDeviceName, cbDeviceName) : 
ErcType 

DESCRIPTION 

SetGPSControl provides the mechanism for appli- 
cations to send control commands to generic print 
devices. Using this request, the application may 
recjuest that the output be halted or paused, that 
the output be canceled, or that the output device 
driver repeat the forms alignment page and pause. 
(Restart commands are sent to generic print 
devices by the SetGPSRestart request, which is 
defined elsewhere in this chapter.) 

SetGPSControl does not use a job handle for 
identification of the device driver due to the 
fact that with spooled output it is necessary to 
provide control commands for documents that were 
created earlier and are no longer open. 



PROCEDURAL INTERFACE 

SetGPSControl (bCommand, bSubCommand, 

pbDeviceName, cbDeviceName) : 
ErcType 



where 



bCommand 



has the following values: 



0 = PAUSE: 



Halt the output of 
data and save it for 
possible future 
printing. 
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SetGPSControl 



(continued) 



1 = CANCEL: Halt the output of 

data and inform the 
device that no more 
data will be forth- 
coming. Discard any 
currently buffered 
data and any any 
future write com- 
mands until a proper 
start-up command is 
received . 

2 = ALIGN Output the alignment 

form and pause . 

3 = JOBCHANGE: Define a print- job 

change. (See defi- 
nition below for 
JOBCHANGE . ) This 
JOBCHANGE command is 
to be used only 
after all data for 
the previous job has 
been sent to the 
device driver, and 
before any data for 
the next document 
has been sent to the 
device driver . 

4 = NOP-1: Reserved. 

5 = NOP - 2 : Reserved . 
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SetGPSControl 



(continued) 



bSubCommand has the following values when 
bCommand = 3 (JOBCHANGE) : 

0 = Invalid 

1 = Beginning of a banner document. 

Implies end of any previously 
existing print job, since a 
banner does not have page 
numbers . 

2 = Beginning of document. 

3 = End of existing job. 

4 = End of this copy. 

5 = Document password required. 

5 = Document password no longer 
required . 

7 = Existing job ended due to 

error . 

8 = Beginning of error -message 

document . 
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SetGPSControl 



(continued) 



pbDeviceName 

cbDeviceName describe a character string of the 
form [devname] , where devname is an 
alphanumeric string of up to 12 
characters . 

REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntInf o 


1 


8 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


0 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


804Bh 


12 


bCommand 


1 




13 


bSubCommand 


1 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDeviceName 


2 
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SetGPSParams 



Request 



SetGPSParams (jh, pJobParameters , sJobParameters) : 
ErcType 



DESCRIPTION 

The SetGPSParams request provides information to 
the GPS system about a job that has just been 
opened with the OpenGPSFile rec[uest, GPS printing 
can be performed without using this SetGPSParams 
request, but it is strongly recommended that it be 
used with all OpenGPSFile requests. For certain 
GPS-print facilities, the SetGPSParams rec[uest 
must be used. The information provided by this 
request, 

1. Controls the queuing and printing of this 
file. 

2 . Enhances the information returned by 
subsequent requests for output -status 
information. 

This request, if present, must follow an 
OpenGPSFile request, and must precede any 
WriteGPSFile request for that job. 

Note that if your application is also using GPAM 
routines, you do not need to use this request 
since GPAM does it for you. 
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SetGPSParams 



(continued) 



PROCEDURAL INTEBIFACE 

SetGPSParams (Jh, pJobParameters, sJobParameters) : 
ErcType 

where 

jh is a job handle returned from an 

OpenGPSFile operation. 

pJobParameters 

sJobParameters define a buffer containing a data 
structure which specifies that 
various control and information 
parameters are to be associated 
with this document. This data 
structure is defined in Table 
7-9. It also displays in the 
Print Manager and is used by the 
spooler . 
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SetiGPSParams 



(continued) 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntlnfo 


1 


2 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


0 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


804Dh 


12 


Jh 


2 




14 


pJobParameters 


4 




18 


sJobParameters 


2 
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SetGPSRestart 



Request 



SetGPSRestart (pbDeviceName, cbDeviceName, 

pDocLocation, sDocLocation, wCopy) : 
ErcType 



DESCRIPTION 

The SetGPSRestart request provides the mechanism 
for applications to send restart control commands 
to generic output devices that have previously 
been paused. A generic device may be requested to 
continue its paused output, or to resume its 
output at a different position in the document. 
The total number of pages per copy and the total 
n\juiiber of copies to be output may be changed by 
this request. 

For direct printing and plotting, restart may only 
commence at the current byte in the output stream; 
any ending-page specification is ignored. Spooled 
output may use any of the restart options. 

SetGPSRestart does not use a job handle for 
identification of the device driver due to the 
fact that with spooled output it is necessary to 
provide control commands for documents which were 
created earlier and are no longer open. 
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SetGPSRestart 



(continued) 



PROCEDURAL INTERFACE 

SetGPSRestart (pbDeviceName, cbDeviceName , 

pDocLocation, sDocLocation, wCopy) : 
ErcType 

where 

pbDeviceName 

cbDeviceName describe a character string of the 
form [devname] , where devname is an 
alphanumeric string of up to 12 
characters . 

pDocLocation 

sDocLocation is a buffer containing Document- 
Location records that define: 

1 . where in the document 
output is to be restart- 
ed ; or 

2. which pages of the docu- 
ment are to be printed. 
This buffer is to contain 
two PageLocation records . 
The first defines the 
Restart "Beginning Page, " 
and the second defines 
the Restart "Ending 
Page." See Table 7-10 
for the definition of the 
PageLocation record and 
its values and uses . 



GPS Routing Switch Recjuests 7-37 



SetG3PSRestart 



(continued) 



Valid PageLocation record specification-class 
values for use with this request are as follows: 



If the "Ending Page" specification is of Original 
Pag e type, then the location specified is only for 
purposes of restarting. Otherwise, the specified 
pages redefine which pages of the document are to 
be printed for each copy. 

wCopy redefines the Current -Copy value 



Beginning Page 



Ending Page 



First/Last 
Logical 
Physical 
Backup Restart 
Original Page 
Continue Restart 
Next-Page Restart 
TopOfPage Restart 



First/Last 
Logical 
Physical 
Pages Beyond 
Original Page 



for this document -output job. 
value of zero indicates no change. 



A 
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SetGPSRestart 



(continued) 



REQUEST BLOCK 



Offset Field 



Size 
(bytes) 



Contents 



0 


sCntInf o 


1 


8 


1 


xv.t.v^oa.e 


J. 


n 
u 


2 


nReqPbCb 


1 


2 


3 


nRespPbCb 


1 


0 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


804Eh 


12 


wCopy 


2 




14 


reserved2 


2 




16 


reserved3 


2 




18 


reserved4 


2 




20 


pbDeviceName 


4 




24 


cbDev i ceName 


2 




26 


pDocLocation 


4 




30 


sDocLocation 


2 
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SetlmageModeGPS 



Request 



SetlmageModeGPS (jh, mode) : ErcType 
DESCRIPTION 

The SetlmageModeGPS rec[uest sets normal, image, 
or binary mode for a GPS byte stream. 

Mode controls the way the printing device 
interprets line control characters and escape 
sequences, thereby controlling your ability to 
pass printer-specif ic escape sequences through to 
the printing device with your output stream. 

• Normal mode converts any tab symbols in 
the stream of characters passed to the 
printing device into spaces and maps all 
line feeds to the line control 
specifications set at device installation 
time . 

• Image mode suppresses all character 
conversions, except pre-GPS printer or 
spooler escape sequences . (See the 
Exegutive Manual.) 

• Binary mode passes all characters to the 
printer with no interpretation at all . 

Note that if your application is also using GPAM 
routines, you do not need to use this request 
since GPAM does it for you. 
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Set ImageModeGPS 



(continued) 



PROCEDURAL INTERFACE 

SetlmageModeGPS (jh, mode) : ErcType 
where 

jti is a job handle returned from an 

OpenGPSFile operation. 



mode 


is 


a code as follows 


* 




0 


for 


normal mode 






1 


for 


image mode 






2 


for 


binary mode 




REQUEST 


BLOCK 














Size 




Offset 


Field 




(bytes) 


Contents 


0 


sCntlnfo 




1 


4 


1 


RtCode 




1 


0 


2 


nReqPbCb 




1 


0 


3 


nRespPbCb 




1 


0 


4 


userNum 




2 




6 


exchResp 




2 




8 


ercRet 




2 




10 


rqCode 




2 


804Fh 


12 






2 




14 


mode 




2 
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WriteG^SFile 



Request 



WriteGPSFile (jh, pBuffer, sBuffer, psDataRet) : 
ErcType 



DESCRIPTION 

The WriteGPSFile operation transfers a number of 
bytes from memory to the printer. WriteGPSFile 
returns only when the requested transfer is 
complete . 

Note that if your application is also using GPAM 
routines, you do not need to use this request 
since GPAM does it for you. 

This request is best used with small/medium files. 
Use QueueGPSFile for large files. 



PROCEDURAL INTERFACE 

WriteGPSFile (jh, pBuffer, sBuffer, psDataRet) : 
ErcType 



where 



3h 



is a Job handle returned from an 
OpenGPSFile operation. 



pBuffer 



is the memory address of the first 
byte of the buffer from which the 
data is to be written. 
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WriteGPSFile 



(continued) 



sBuffer is the count of bytes to be written 

from memory. 

psDataRet is the memory address of the word 

to which the count of bytes suc- 
cessfully written is to be 
returned . 



REQUEST BLOCK 



Size 



Offset 


Field 


(bytes) 


Contents 


0 


sCntlnfo 


1 


2 


1 


RtCode 


1 


0 


2 


nReqPbCb 


1 


1 


3 


nRespPbCb 


1 


1 


4 


userNum 


2 




6 


exchResp 


2 




8 


ercRet 


2 




10 


rqCode 


2 


8039h 


12 




2 




14 


pBuf fer 


4 




18 


sBuf fer 


2 




20 


psDataRet 


4 




24 


ssDataRet 


2 


2 
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REFEEIENCE TABLES 



Table 7-2 

FORMAT OF AddGPSDevice DEVICE STRUCTURE 
(Page 1 of 2) 



Offset Field 

0 sbDeviceName 



Size 
(bytes) 

13 



13 



sbAlias 



13 



26 



sbNode 



13 



Contents 

The name of the 
output device (the 
first byte of an 
"sb" string is the 
length of the 
string) . 

An alias name for 
the output device 
assigned by the 
Print Manager in 
order to avoid dup- 
licate printer 
names when more 
than one occurrence 
of a particular 
driver exists with- 
in the network. 

CT-Net node where 
the device is 
located . 
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Table 7-2 



FORMAT OF AddGPSDevice DEVICE STRUCTURE 
(Page 2 of 2) 



39 



sbLocation 



25 Geographic location 
of printer. This 
field can be dis- 
played by appli- 
cation programs to 
aid the user in lo- 
cating the printer 
to which output is 
directed . 



64 



65 



fSpooled 



fBanner 



TRUE if the device 
is to be controlled 
by the spooler . 

TRUE if the device 
driver is to print 
a banner page at 
the beginning of 
each document . 



66 



sbQueueNameRoot 13 



A root name for the 
set of queues to be 
used for spooled 
device control . 



79 



fAtMaster 



TRUE if device is 

located at the 

master of a 
cluster . 



80 
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Table 7-3 



FORMAT OF GPS NET LIST 
(Page 1 of 1): 



Offset Field 

0 nPrinters 

2 sRgPr inter 



Size 
(bytes) 



4 sbGPSVerslon 8 



12 rgPr inter 



81*n 



Contents 

The nuniber 
printers in 
table . 



of 
this 



The size of the 
rgPrinter data 
structure follow- 
ing. nPrinters * 
sRgPr inters + 12 is 
the total required 
size in bytes of 
this data 
structure . 

String containing 
the GPS -version 

number . 

See Table 7-2 for 
rgPrinter format. 
There are nPrinters 
occurrences of 
rgPrinter in this 
table . 
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Table 7-4 



DEVICE CONFIGURATION INFORMATION 

(Page 1 of 2) 



Offset Field 

0 sbDeviceName 

13 f Alpha 



14 fGraph 



15 sbVersion 



Size 
(bytes) 

13 



13 



28 sbAlias 



13 



Contents 

The name o f 
output device . 



the 



If set to TRUE, the 
output device can 
be used for alpha- 
numeric output . 

If set to TRUE, the 
output device can 
be used for graphic 
output . 

The first 12 char- 
acters of the ver- 
sion specified when 
the device driver 
was linked. 

An alias name for 
the output device 
assigned by the 
Print Manager in 
order to avoid dup- 
licate device names 
when more than one 
occurrence of a 
particular driver 
exists within the 
network . 
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Table 7-4 



DEVICE CONFIGURATION INFORMATION 
(Page 2 of 2) 



41 vmSpeed 



43 sbNode 



2 Output device speed 
in characters per 
second. This in- 
formation is useful 
for timing pur- 
poses . 

13 CT-Net node where 
the device resides . 



56 sbLocation 



81 



82 



f Spooled 



f AtMaster 



25 Geographic location 
of device. This 
field can be dis- 
played by applica- 
tion programs to 
aid the user in 
locating the device 
to which output is 
directed. (For ex- 
ample, this field 
might contain the 
information 
"Software Lab" or 
"Printer Room. ") 



TRUE if the 
is spooled. 



device 



TRUE if device is 
located at the mas- 
ter of a cluster. 



83 



sbChannel 



The channel device 
speci f ication . 



92 
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Table 7-5 



DEVICE HISTORY INFORMATION 

(Page 1 of 1) 



Offset Field 

0 cEntriesMax 



Size 
(bytes) 



cEntriesActual 



rgHistory 



133 



Contents 

Count of the total 
number of device 
history entries 
configured for this 
.device. This value 
is defined when the 
driver is built. 

Count of the number 
of entries that 
have valid device 
history informa- 
tion . Not to 
exceed specified 
cEntriesMax . 

See Table 7-6 for 
the format of a 
History entry. 
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Table 7-6 



FORMAT OF A HISTORY ENTRY 
(Page 1 of 1) 



Size 

Offset Field (bytes) 
0 sbDocumentName 93 



93 



124 



sbUserName 



31 



bCompletionStatus 1 



125 



129 



qStartTime 



qFinishTime 



Contents 

The name 
document . 



of the 



Name o f docvament ' s 
owner . 

Status of document 
completion. If 
bCompletionStatus = 

0 Document com- 
pleted normally. 

1 Document was 
aborted by a 
user . 

2 Document was 
aborted because 
of an error . 

Time when the docu- 
ment started print- 
ing in system time 
format . 

Time when the 
document finished 
printing in system 
time format . 



NOTES : 

1. Entire structure (Table 7-5/7-6) = 135. 

2. Sufficient memory must be allocated or no 
information will be put into Table 7-6. 
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Table 7-7 



DOCUMENT INFORMATION 

(Page 1 of 4) 



Offset Field 

0 fDelAftPrt 



Size 
(bytes) 



1 sbFileSpec 



92 



93 



sbFormName 



13 



106 



sbFontName 



13 



119 cCopies 



121 bPrintMode 



Contents 

If set to TRUE 
(OFFH) , the spooled 
file will be 
deleted after it is 
printed. 

The name of the 
file to be printed 
(the first byte of 
an "sb" string is 
the length of the 
string) . 

The name of the 
form to be used. 
I f " the length is 
zero, the standard 
form will be used. 

The name of the 
font to be used. 
If the length is 
zero, the devices' 
standard font will 
be used. 

The number o f 
copies of the file 
that are to be 
printed. 

The printing mode, 
where 



0 = normal 

1 = binary 

2 = image 
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Table 7-7 



DOCUMENT INFORMATION 

(Page 2 of 4) 



Size 

Offset Field (bytes) 
122 fAlignForms 1 



123 fSecurityMode 1 



124 reserved 



129 sbDocName 



221 sbUserName 

252 wTimeToPrint 

254 reserved 

256 t ImeQueued 



92 



31 



Contents 

If this is TRUE, 
the forms alignment 
option will be 
used. 

If this is TRUE, 
the file will be 
printed in security 
mode . 

Reserved for use by 
the Word Processor . 

The name of the 
document being 
printed. This is 
different from 
sbFileSpec, which 
is typically a 
temporary file in 
the [scr]<spl> 
directory. 

The client's user 
name . 

Approximate print 
time in minutes . 

Reserved for V/P . 

The date/time that 
the document was 
qpaeued . 
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Table 7-7 



DOCUMENT INFORMATION 

(Page 3 of 4) 



Size 
(bytes) 



Offset Field 
260 fSuppressNewPage 



Contents 

If TRUE, the device 
driver will not 
print a form- feed 
at the start of the 
document . 



261 fWPPaging 



262 fSuppressBanner 



263 fSingleSheet 



264 flmmediate 



265 qFileSize 



1 If TRUE, the device 
driver will use WP 
page escape secjuen- 
ces to determine 
page numbers . 

1 If TRUE, the device 
driver will not 
print a banner or 
the notice file. 

1 If TRUE, the device 
attached is manual 
feed. 

1 If TRUE, this file 
can commence output 
even before the en- 
tire file has been 
received . 

4 The total number of 
characters in the 
file. 
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Table 7-7 

DOCUMENT INFORMATION 

(Page 4 of 4) 



Size 

Offset Field (bytes) 
269 rgStartPage 29 



298 rgEndPage 



29 



327 bPriority 



328 f Marked 



Contents 

A data structure 
defining where in 
the document to 
commence output . 
See Table 7-10 for 
a description of 
this data 
structure . 

A data structure 
defining where in 
the document to 
terminate output . 
See Table 7-10 for 
a description of 
this data 
structure . 



Queue 
priority, 



entry 



If TRUE, this entry- 
is currently being 
processed. 
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Table 

DEVICE STATUS 
(Page 1 



7-8 

INFORMATION 

of 2) 



Offset Field 
0 wsTable 



Size 
(bytes) 



sbDeviceName 13 



15 reserved 



16 bStatus 



Contents 

Size of this table 
in bytes . This 
value corresponds 
to the number of 
bytes required to 
contain the entire 
table . 



The name 
device . 



of the 



Space reserved for 
former use . 

The device status , 
where 



17 fNeedFont Change 1 



18 fNeedFormsChange 1 



19 fShowPauseMessage 1 



20 sbPauseMessage 61 



0 = idle 

1 = paused 

2 = printing 

3 = offline 

4 = down 

TRUE if a font 
different than the 
current is needed. 

TRUE if a different 
form is needed. 

TRUE if the pause 
message should be 
displayed . 

The pause message 
to be displayed. 
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Table 7-8 

DEVICE STATUS INFORMATION 

(Page 2 of 2) 



Offset Field 

81 sbFontNeeded 



Size 
(bytes) 

21 



102 sbF ormNeeded 2 1 



123 wColor 



125 sbForm 



146 SbF on t 



167 sbDocument 



21 



21 



93 



260 sbUserName 31 

291 rgCurrentPage 29 

320 cCurrentCopy 2 

322 qOutputStartTime 4 



Contents 

The name of the 
font needed. 

The name of the 
form needed. 

The number of the 
current color. 

The name of the 
current form . 

The name of the 
current font . 

The name of the 
current document. 

The client's name. 

The current page 
location record, 
see table 7-10 . 

The index of the 
current copy being 
output . 

The date/time that 
the document was 
started. 



326 
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Table 7-9 



JOB PARAMETERS 

(Page 1 of 3) 



Offset Field 

0 sbDocName 



Size 
(bytes) 

93 



93 sbUserName 31 

124 f Security 1 

125 fSuppressPage 1 

126 fSuppressBanner 1 

127 fTypeThrough 1 

128 f Immediate 1 



129 qDocCreationTime 4 

133 qReqOutputStartTime 

4 



Contents 

Document name to be 
associated with 
this output job. 

Client's User-Name. 

Set if document is 
to be output in 
security mode. 

Set if there should 
be no page eject at 
the beginning of 
this job. 

Set if banner is 
not to be printed 
before printing the 
document . 

Set if output is 
not to be buffered. 

Set if client would 
desire spooled 
output to begin 
before spooling is 
completed . 

Time that document 
was created. 



Time after which 
document is to be 
output . 
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Table 7-9 



JOB PARAMETERS 
(Page 2 of 3) 



Offset Field 
137 wcCopies 



Size 
(bytes) 



139 rgbStartLocation 29 



168 rgbEndLocation 29 



Contents 

Number of copies of 
document to be 
output . 

PageLocation record 
that specifies 
which page of the 
document should be- 
gin each copy of 
the document. (See 
Table 7-10 for the 
definition of the 
PageLocation record 
and its values & 
uses . ) 

PageLocation record 
that specifies 
which page of the 
document should end 
each copy of the 
document . (See 
Table 7-10 for the 
definition of the 
PageLocation record 
and its values and 
uses . ) 
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Table 7-9 



JOB PARAMETERS 
(Page 3 of 3) 



Offset Field 



Size 
(bytes) 



Beginning Page 

First/Last 

Logical 

Physical 



197 fSingleSheet 



198 wTimeToPrint 



Contents 

Valid PageLocation 
record 

speci f ication-class 
values : 

Ending Page 

First/Last 
Logical 
Physical 
Pages Beyond 

I f TRUE , pause 
between pages when 
printing. 

Approximate print 
time in minutes . 



200 bPriority 



Queue 
priority, 



entry 



201 
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Table 7-10 



PAGE LOCATION RECORD DEFINITION 
(Page 1 of 1) 



Each GPS Page Location record has the following 
structure : 



Offset Field 
0 bClass 



Size 
(bytes) 



16 



cwPages 



sbSection 



sbPage 



13 



13 



Contents 

The value of this 
byte speci f ies the 
type, or class, of 
page specification 
contained in the 
rest of this Page 
Location record. 
The values are all 
explained in the 
following 
description . 

See the following 
description . 

See the following 
description . 

See the following 
description. 



29 



Ejqplanation : 

The GPS PageLocation record is used to specify a 
GPS document page physically, logically or 
implicitly. The information that follows explains 
how it is used. 



7-60 Generic Print System Programmer's Guide 



A user of the Generic Print System uses the 
PageLocation record for one of two purposes: 

1 . When first requesting that a document be 
printed, PageLocation records may be 
used to specify how much of the document 
is to be printed. 

2. When restarting a print job, 
PageLocation records may be used to 
specify where to restart, and how much 
of the document to print. 

A physical page N is the Nth page in the document . 
The beginning of a page is defined as anything 
that results in an ejq^licit Form Feed. 

A logical page is defined by a logical -section 
string and a logical -page-number string. These 
strings, if they exist, are included in documents - 
as explicit Beginning- of -Page definitions. 
Currently, logical -section strings are not 
included in any documents. So, GPS drivers will 
set the logical-section string to "1" at the 
beginning of a document. And one will be added to 
the logical -section string each time that the 
logical -page-number string does not increase. 

GPS -document pages may be specified according to 
the following classes: 

A. First/Last: If the PageLocation record 

is specifying a "beginning" 
page, it is the document's 
first page; if it is 

specifying an "ending" page, 
then it is the last. This 
class of PageLocation speci- 
fication is used when the 
bClass field of the 
PageLocation record is set 
to 0. 
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B. Continue Restart: 



This is one of the classes 
which may be used only to 
specify where a restart 
should begin; this class 
specifies that printing will 
begin at the item following 
the last item output. The 
bClass - field value for this 
specification is 1. 

C. Next -Page Restart: 

This is one of the classes 
which may be used only to 
specify where a restart 
should begin; this class 
specifies that printing will 
begin at the page following 
the last one being output. 
The bClass - field value for 
this specification is 2. 

D. Logical: A logical-page specifica- 

tion consists of a Section-# 
string and a Page-# string. 
Only pages that have been 
generated with associated # 
strings may be "logically" 
speci f ied . When a 

PageLocation record contains 
a logical specification; the 
IsQls&S. field = 3, the 
sbSection field contains the 
Section-# string, and the 
sbPag e field contains the 
Page-# string. 
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E. Physical: A physical -page specifica- 

tion consists of the page's 
physical index in the 
cvPages field of the 
PageLocation record. And 
the bClass field = 4. 

F. TopOfPage Restart: 

This is one of the classes 
which may be used only to 
specify where a restart 
should begin; this class 
specifies that printing will 
begin at the top of the page 
that was being output . The 
bClass -field value for this 
specification is 5. 

G. Backup Restart: 

This is one of the classes 
which may be used only to 
specify where a restart 
should begin; this class 
specifies that printing will 
begin at the top of the page 
that is N pages before the 
page that was being output . 
The bClass -field value for 
this specification is 5, and 
the value N is in the 
cwPages field of the 
PageLocation record. 

H. Pages Beyond: 

Only the ending page may be 
specified by this class of 
PageLocation record. This 
class specifies that the 
last page of this document 
to be printed is the page 
that is N physical pages 
beyond the beginning page . 
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The bClass - field value for 
this specification is 8, and 
the value N is in the 
cwPages field of the 
PageLocation record 

I . Original Page: 

This class specifies that 
the beginning-page or 
ending-page should be kept 
as specified in the original 
GPS print request . For this 
class, 7 is the bClass - field 
value . 

J . Current Page : 

This class specification is 
used to signal that the 
PageLocation record contains 
current -page status in for — 
mation (for example, which 
page is currently being 
printed) . The page's logi- 
cal Section-# and Page-#, if 
it has them, are in the 
sbSectlon and sbPage fields. 
The page ' s physical index is 
in the cwPages field, and 9 
is the value in the 
bClassppp field. 
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8 TROUBLESHOOTING 



STATUS CODES 

The following list includes status codes that can 
occur with the printing system . For a more 
detailed listing of status codes, see the Status 
Codes Manual • 



DEVICE DRIVER STATUS CODES 

4544 Mode Value Error . 

An invalid Image-Mode value was 
specified. 

4545 Buffer Too Small. 

The supplied data buffer was too small 
for the requested data . 

4546 Begin-Page-Class Error. 

An invalid value was specified for 
"Beginning-Page" class. 

4547 Ending-Page-Class Error. 

An invalid value was specified for 
"Ending-Page" class. 

4548 Command-Value Error . 

An invalid value was specified for the 
Control Conmiand. 

4549 Sub -Command -Value Error . 

An invalid value was specified for the 
Control Sub-Command. 
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4550 to 
4551 



Reserved for internal use. 



4552 
4553 

4554 
4555 
4556 

4557 

4558 

4559 to 
4566 

4557 



4568 to 
4570 



This request to GPS is not appropriate 
at this time . 

Current operation upon this GPS device 
must be completed before this request to 
GPS may be made. 

Reserved for internal use . 

Reserved for internal use . 

Driver Deinstalling. 

Request cannot be serviced, because the 
device driver for the requested device 
is currently being removed. 

Cancelled Job. 

This job has been cancelled -- this data 
will not be output. 

No Such Doc. 

The specified document does not exist. 
Reserved for internal use . 



Cannot Acquire Device. 

Device driver cannot acquire access to 
the device's output port, because 1) GPS 
has already acquired this port, or 2) 
some application is currently using the 
port . 

Reserved for internal use. 
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4571 



String Too Long. 



A name passed to GPS is too long. 

4572 Transparent Mode error. 

An error has occurred with an attempt to 
send GPAM data to the printer in 
transparent mode3 . 

4573 Bad Data. 

The device driver has encountered data 
in the document that it cannot process, 
for example a nonprintable file has been 
sent to the printer for printing. 

4574 No such font. 

4575 Internal error. 

ROOTING SWITCH STATUS CODES 

4576 Device not installed. 

The requested device is not currently 
installed. 

4577 Bad request file. 

You have an incorrect version of the 
Request file, [Sys] <Sys>Request . 9 . Sys . 
Check your distribution diskette. 

4578 A workstation prefix is required if the 
routing switch is installed at a 
diskless workstation. 

4579 Internal error. 

4580 See error 4591. 
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4581 to 
4582 

4583 
4584 
4585 

4586 
4887 

4588 

4589 
4590 

4591 



Internal error . 



An invalid request code lias been 
detected . 

Cannot deinstall GPS when running on a 
single partition OS . 

Device driver has not yet identified 
itself, therefore this device cannot be 
activated. 

Duplicate device spec. 

An attempt was made to add a device that 
already exists . 

An attempt was made by GetGpsDocInfo to 
read additional entries for a direct 
print device . 

On direct print devices, document 
information is available only of the 
document currently printing. 

An attempt was made to read beyond the 
end of a device scheduling cjueue by the 
GetGPSDocInfo request. 

Internal error . 

A direct print device is already opened 
by another user . 

Exceeded maximum number of 

simultaneously open device streams. 

Either reduce the number of 
simultaneously open devices or increase 
the [Maximum number of open files 
(default=12) ] value specified at the 
time of routing switch installation. 
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4592 



Network device table is full. 



Either reduce the number of devices 
known to the routing switch or increase 
the [Maximum number of network devices 
(def ault=10) ] value specified at the 
time of routing switch installation. 

4593 Unbalanced brackets on device spec. 

4594 Invalid node specification. 

4595 Routing switch internal error . 

4596 Routing switch internal error . 

4597 Routing switch internal error . 

4598 The device name is not recognized. 

4599 The device table is full. 

Either reduce the number of devices 
known to the routing switch or increase 
the [Maximum number of local devices 
(default=3) ] value specified at the time 
of routing switch installation. 



SPOOLER STATUS CODES 

712 The device handle in the request was 
unrecognized . 

713 An attempt was made to supply a password 
when the spooler was not waiting for 
one . 

715 An attempt was made to install a device 

with the same name as one already in 
use . 
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716 
717 



Internal error. 



The spooler device table is full . 



Either reduce the number of devices or 
reinstall the spooler with a larger 
maximum number of devices. 

718 An attempt was made to access an 
uninstalled device. 

719 Internal error 

72 0 An attempt was made to remove a device 

which was not in service. 

721 An attempt was made to process a Job 
with an unrecognized spooler job index. 

722 The spooler was unable to handle a new 
spooling job. 

72 3 GPS spooler not installed. 

The spooler is not currently installed. 

724 Queue Manager not installed. 

725 Illegal command. 



QUEUE MANAGER STATUS CODES 

915 The queue table is full. 

Either reduce the number of queues or 
reinstall the queue manager with a 
larger maximum number of queues. 

916 The queue handle in the request was 
unrecognized . 
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917 An attempt was made to remove a queue 
that is no longer in service. 

918 An attempt was made to install a queue 
with a file specification matching that 
of a queue already in service. 

919 An attempt was made to install a queue 
with a name matching one already in 
service . 

920 Internal error 

921 An attempt was made to install the queue 
manager with an illegal installation 
parameter . 



Troubleshooting 8-7 



APPENDIX A: CONVERTING NON-GPS APPLICATIONS 



An application system that was not written or 
modified for use with the the Generic Print System 
probably includes device-specific codes in its 
output to the printer . To convert such a system 
you may want to do the following: 

• Rewrite the system using GPAM. For long- 
range use with workstations, this is the 
best choice, since it gives you complete 
device independence . 

• If the system was originally written for 
CTOS, you can replace the printer or 
spooler specification in any calls to 
OpenByteStream with a specification for a 
GPS printer name, then relink with 
GPAM. lib, and a 10.0 or higher version of 
CTOS. lib. 

Since, in this case, you are leaving 
device-dependent information in your 
output stream, you must be careful that 
the output does indeed go to that kind of 
printer. For example, you can do this by 
adding code to check the printer type . 
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GLOSSARY 



application system. An application system is any 
application program, written by either the user or 
vendor . 

aspect. The aspect ratio is the ratio of height 
to width of any rectangle. 

buffer. A buffer is an area of memory used to 
store information temporarily. 

byte stream. A generic stream of bytes, called a 
byte stream , is sent to SAM to be routed to the 
specified device. 

Byte Stream Work Area. A Byte Stream Work Area is 
a 130 -byte memory work area for the exclusive use 
of Sequential Access Method procedures. Any 
number of byte streams can be open concurrently, 
using separate Byte Stream Work Areas . 

cliister. A cluster configuration is a local 
resource- sharing network consisting of a master 
workstation and up to 16 cluster workstations. 

data stream. A data stream consists of text and 
device- independent formatting commands sent to the 
printing device in much the same way that you send 
a GPS byte stream. The GPAM data stream is 
translated into device -specific commands by a 
device driver specific to each device. 

device driver. The GPS device driver is an 
installed system service that controls a printing 
device and translates the Generic Print Access 
Method byte stream it receives into 
device-specific commands. Device drivers are 
usually unique for each type of printing device. 

direct printing. Direct printing is printing that 
transfers text directly to the printer. 

escape sequence. An escape sequence is a special 
sequence of characters that invokes special 
functions . 



Glossary G-1 



exchange. An exchange is the path over which 
messages are conmunicated from process to process 
(or interrupt handler to process) . An exchange 
consists of two first-in, first-out queues; one of 
the processes waiting for messages, the other a 
queue of messages for which no process has yet 
waited. An exchange is referred to by a unique 
16 -bit integer. 

job handle. A job handle is a 16-bit integer that 
uniquely identifies an open request. A job handle 
is returned by the request, OpenGPSFile and is 
used to refer to the file in subsequent operations 
such as ReadGPSFile or WriteGPSFile . 

Generic Print Access Method. The Generic Print 
Access Method (GPAM) is a library of object module 
procedures that you can use to completely free 
your application from device-specific printer or 
plotter commands. If you want your application to 
offer rich formatting, such as boldface text, 
underlines, superscript, or graphics, you can 
format your output as a GPAM data stream. The 
data stream consists of text and 
device- independent formatting commands sent to the 
printing device in much the same way that you send 
a GPS byte stream. The GPAM data stream is 
translated into device-specific commands by a 
device driver specific to each device. 

landscape aspect. Printing on a rectangular page 
where the main axis runs the width of the page (as 
on this page), is called the landscape aspect. 

node. A node is a location in a CT-Net network of 
workstations. It can be a master or a standalone 
workstation . 

object module procedure. An object module 

procedure is a procedure supplied as part of an 
object module file. It is linked with the user- 
written object modules of an application system. 
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pb/cb. A pb/cb is a 5 byte entity consisting of 
the 4 -byte memory address of a byte string 
followed by the 2 -byte count of the bytes in that 
byte string. 

portrait aspect. Printing on a rectangular page 
where the main axis runs the length, rather than 
the width of the page, is called the portrait 
aspect . 

queue manager. The Queue Manag er handles all 
cjueues of jobs for the cluster and is also used by 
non-printing applications, such as Batch. One 
Queue Manager is installed on the master 
workstation of any cluster where spooled devices 
are installed. 

request block. A request block is a block of 
memory containing request information, submitted 
by a client process to a system service. Request 
blocks are exchanged by the system service and the 
client process by sending the memory address of 
the request block. Request blocks are used most 
often when the client process want to continue 
processing rather than to wait at an exchange for 
the system service to return. 

routing switch. A routing switch is a system 
service that routes requests to the designated 
printing device and coordinates the work of the 
entire Generic Print System. The routing switch 
also handles printer control commands (such as 
pause and restart) , and status enquiries . Routing 
switches within a cluster or network communicate 
with each other to pass requests or status 
information. A routing switch is installed on any 
workstation to which a printer is attached and on 
the master workstation of any cluster. 

Sequential Access Method. The CTOS Sequential 
Access Method provides device -independent calls an 
application can use to access real devices, such 
as the video, keyboard, or printer. These calls 
send a generic stream of bytes, called a byte 
stream . through SAM to the specified device. 
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spooled printing. Spooled printing is a printing 
process that transfers text to a print queue. 

spooler. The spooler gives a print request to the 
Queue Manager to place in the print queue and, 
when the printing device is free to print asks for 
the print request back again. The spooler is 
installed on each workstation to which a spooled 
device is attached . 

system service. A system service is like a 
modular part of the operating system that resides 
in workstation memory. Some system services can 
be dynamically installed (added or removed at any 
time) . System services are not a part of the 
operating system when it is first installed, nor 
are they resident after a system is bootstrapped 
unless you make special entries in your system 
initialization file for their installation. 

VDM file. A VDM file is a graphics output file 
originally created using the Graphics. lib routine, 
WriteVDM. 
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INDEX 



AddGPSDevice 

format of device structure, 7-44 to 7-45 

Application 

adding status fvinctions to, 5-7 
converting a non-QPS, 3-1, A-1 
linking to include byte streams, 3-3 
use of Queue Manager with, 2-12 to 2-13 



Boldface 

assigning, 4-12 
Byte streams 

description of, 2-2 to 2-3 

use of, 3-1 to 3-3 



Carriage Return (ODh) , 4-10 
CGM 

using files created with, 4-17 

CGM files 

writing with GPAMWriteRecord, 4-14 

Character placement 

specifying, 4-11 to 4-12 
using GPAMPlaceCharacter , 4-12 

CloseGPSFile, 7-4 

Cluster workstation 
definition of, 1-2 

Color Table 

assigning to text with GPAMSetColor , 4-12 
setting color table with GPAMGrSetColorTable, 4-15 
setting with GPAMGrSetColorTable, 4-15 
specifying for line with GPAMGrLineColor , 4-16 
specifying for perimeter with CT>AMPerimeterColor , 
4-16 

specifying interior with GPAMGrFillColor , 4-17 
Coordinate base 

placing characters using, 4-11 
Coordinates 

specifying page, 4-11 

specifying polygon, 4-16 
Cross-hatching 

specifying with GPAMGrHatchlndex, 4-17 



Daisy wheel printer 

device driver (DaisyDD.Run) , 2-11 
Data stream 

closing with GPAMClose, 4-8 

opening with GPAMOpen, 4-8 

structure, 4-8 
example of, 4-9 
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DeleteGPSJob, 7-6 
Device configuration 

querying GPS with GetGPSDevConf ig, 5-5 
Device driver 

daisy wheel (DaisyDD .Run) , 2-11 

description of, 2-8 

generic (LptSimpleDD .Run) , 2-11 

use of, 2-10 to 2-11 
Device history 

history entry, format of, 7-50 

history information, 7-49 
Device status information, 7-55 to 7-56 
Document information, 7-51 to 7-54 
Draft quality output 

definition of, 2-11 

device driver for, 2-11 



Error codes, 8-1 to 8-7 
Errors 

resolving with GPAMRelease, 4-8 



Fonts 

specifying with GPAMSetFont, 4-13 
Form Feed (OCh) 

using GPAMBeginPage in place of, 4-10 



Generic Print Access Method (GPAM) 

description of, 2-2, 2-5 

linking with, 4-3 

procedures, 4-4 to 4-7 
summary of, 6-2 to 6-5 

specifying graphics output with, 4-2 

use of, 4-1 to 4-17 
Generic Print Access Method procedures 

CT>AMBeginBold, 6-6 

GPAMBeginBound, 6-7 

GPAMBeginltalic, 6-9 

GPAMBeginOver strike, 6-10 

GPAMBeginPage, 6-12 

GPAMBeginTransparent, 6-17 

GPAMBeginUnder score, 6-18 

GPAMClose, 6-20 

GPAMEndBold, 6-21 

GPAMEndBound, 6-22 

GPAMEndltalic, 6-23 

GPAMEndOver strike, 6-24 

GPAMEndTransparent, 6-25 

GPAMEndUnder score, 6-26 

GPAMGr BeginGr aphics , 6-49 

GPAMGrColorTable, 6-51 
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Generic Print Access Method procedures (cont.) 

GPAMGr EndGr aphics , 6-53 

GPAMGrFillColor, 6-54 

GPAMGrHatchlndex, 6-55 

GPAMGr Inter iorStyle, 6-56 

GPAMGrLineColor, 6-57 

GPAMGrLineType, 6-58 

GPAMGrPerimeterColor, 6-59 

GPAMGrPolygon, 6-60 

GPAMGrPolyLine, 6-62 

GPAMLineFeed, 6-27 

GPAMOpen, 6-28 

GPAMPlaceCharacter, 6-34 

GPAMRe lease, 6-35 

GPAMReposition, 6-36 

GPAMSetColor, 6-39 

GPAMSetFont, 6-40 

GPAMSetSLD, 6-42 

GPAMSetVerticalOffset, 6-43 

OTAMWhiteSpace, 6-45 

GPAMWriteRecord, 6-46 
Generic Print System (GPS) 

description of, 1-1, 2-1 to 2-2 

direct calls to, 5-1 to 5-8 

installation of, 1-2 

progreonming with, 2-2 
Generic Print System Net List 

format of, 7-46 
GetGPSDevConfig, 5-5 
GetGPSDevConfig, 7-10 
GetGPSDevHi story, 7-8 
GetGPSDocInfo, 7-12 
GetGPSNetList, 7-15 
GetCTSSplVolStatus, 7-18 
GetGPSStatus , 7-20 

GPAM Data stream. See Data stream. 
GPAM. See Generic Print Access Method. 
GPAMBeginBold, 6-6 
GPAMBeginBound, 6-7 
GPAMBeginGr aphics, 4-14 
GPAMBeginltalic, 6-9 
GPAMBeginOver strike, 6-10 
GPAMBeginPage, 4-10, 6-12 
GPAMBeginTransparent, 4-14, 6-17 
GPAMBeginUnder score, 6-18 
GPAMClose, 4-8, 6-20 
GPAMEndBold, 6-21 
GPAMEndBound , 6-22 
GPAMEndltalic, 6-23 
GPAMEndOver strike, 6-24 
GPAMEndTransparent, 4-14, 6-25 
GPAMEndUnder score, 6-26 
GPAMFillColor, 4-17 
GPAMGrBeginGraphics, 6-49 
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GPAMGrColorTable, 6-51 
GPAMGrEndGraphics, 6-53 
GPAMGrFillColor, 6-54 
GPAMGrHatchlndex, 4-17, 6-55 
GPAMGrlnteriorStyle, 4-16, 6-56 
GPAMGrLineColor, 4-16, 6-57 
GPAMGrLineType, 6-58 
GPAMGrPerimeterColor , 6-59 
GPAMGrPolygon, 6-60 
GPAMGrPolyLine, 6-62 
GPAMGrSetColorTable, 4-15 
GPAMLineFeed, 4-11, 6-27 
GPAMOpen, 4-13, 4-8, 6-28 
GPAMPlaceCharacter , 4-12, 6-34 
GPAMPolyLine, 4-15 
GPAMRelease, 6-35 

resolving GPS errors with, 4-8 
GPAMReposition, 4-12, 6-36 
GPAMSetColor, 4-12, 6-39 
GPAMSetFont, 4-13, 6-40 
GPAMSetSLD, 6-42 

GPAMSetVerticalOf fset, 4-12, 6-43 
GPAMWhiteSpace, 6-45 
GPAMWriteRecord, 6-46 

writing CGM files with, 4-14 
GPS Byte Streams . See Byte streams . 
GPS Device Driver . See Device driver . 
GPS PageLocation record, 7-60 
GPS Routing Switch. See Routing switch. 
GPS. See Generic Print System. 
Graceful degradation, 2-5, 4-3 
Graphics output 

from existing CGM file, 4-2 

specifying with GPAM, 4-2 
Graphics procedures 

descriptions of, 4-15 to 4-17 

CTAMGr BeginGraphics , 6-49 

GPAMGrColorTable, 6-51 

GPAMGr EndGr aphi cs , 6-53 

GPAMGrFillColor, 6-54 

GPAMGrHatchlndex, 6-55 

GP AMGr Inter iorStyle, 6-56 

GPAMGrLineColor, 6-57 

GPAMGrLineType, 6-58 

GPAMGrPerimeterColor, 6-59 

GPAMGrPolygon, 6-60 

GPAMGrPolyLine, 6-62 

use of, 4-9 
Graphics 

outputting with GPAM, 4-14 

positioning, 4-15 

scaling, 4-15 
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Hatching 

specifying with OPAMGrHatchlndex, 4-17 
Horizontal tab (09h) . 4-10 
Installation 

Generic Print System, 1-2 

Queue Manager, 2-13 
Interior color 

specifying with OPAMGrFlllColor , 4-17 



Job parameters, 7-57 to 7-59 



Legal characters 

definition of, 4-10 
Letter quality output 

definition of, 2-11 

device driver for, 2-11 
Line feed 

distance, setting with GPAMSetSLD, 4-11 
using CTAMLlneFeed, 4-11 
using Return (OAh) , 4-11 
Lines 

specifying colors with GPAMGrLineColor , 4-16 
specifying coordinates with GPAMPolyLlne, 4-15 
specifying type with GPAMGrLlneType, 4-16 

Logical page 

definition of, 7-61 

LptSlmpleDD . Run 

description of device driver, 2-11 



Master workstation 
definition of, 1-3 



Non-OTAM commands 

sending to printer with GPAMBeginTransparent, 4-14 
Non-GPS applications 

converting, 3-1, A-1 



OpenGPSFlle, 5-2, 5-5, 7-22 
Output 

draft quality, 2-11 

interrupting with GPAMOpen, 4-13 

letter quality, 2-11 
Output device (s) 

configuration information, 7-47 to 7-48 

controlling with SetGPSControl , 5-7 

format of history entry, 7-50 

history Information, 7-49 

listing default with GetGPSDe faultPr inter , 5-6 
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Output device (s) (cont . ) 

listing with GetGPSNetList , 5-6 

restarting with SetG5>SRestart, 5-7 

specifying a, 5-6 
Over striking 

assigning, 4-12 



Page location record definition, 7-60 to 7-64 
Page, logical 

definition of, 7-61 
Page, physical 

definition of, 7-61 
Pagination, 4-10 

starting with GPAMBeginPage, 4-10 
Physical page 

definition of, 7-61 
Polygons 

defining interior color with GPAMFillColor , 4-17 

specifying coordinates with GPAMGrCoordinate, 4-16 

specifying interior with GP AMGr Inter iorStyle, 4-16 
Print Manager 

description of, 1-2 
Print position 

specifying , 4-11 to 4-12 

using GPAMResposltlon, 4-12 
Print request 

checking status with GetGPSDocInfo, 5-7 

deleting with DeleteGPSJob, 5-7 

making with GPS output functions, 5-2 
Printer (s) 

configuration information, 7-47 to 7-48 
controlling with SetGPSControl, 5-7 
format of history entry, 7-50 
graceful degradation, 2-5 
history information, 7-49 

listing default with GetGPSDe faultPr inter , 5-6 

listing with GetGPSNetList, 5-6 

restarting with SetGPSRestart, 5-7 

sending non-GPAM commands to, 4-14 

sending output to, 3-2 to 3-3 

specifying a, 3-2, 5-6 
Printing mode 

setting with SetlmageModeGPS , 5-6 
Program 

converting a non-GPS, 3-1, A-1 
linking to include byte streams, 3-3 
ProvideGPSPassword, 7-22 
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Queue Manager 

description of, 2-9 
installation of, 2-13 
Queue. Index file, 2-12 
Queueb. Index file, 2-13 
use of, 2-12 

use with non-GPS applications, 2-12 
QueueGPSFile, 7-26 



Return (OAh) , 4-10 
Routing switch 

description of, 2-8, 5-1 

summary of requests, 5-3 to 5-4, 7-2 to 7-3 
use of, 2-9 to 2-10 
Routing Switch requests 
CloseGPSFile, 7-4 
DeleteCT>SJob, 7-6 
GetGPSDevConfig, 7-10 
GetGPSDevHi story, 7-8 
GetGPSDocInfo, 7-12 
GetGPSNetList, 7-15 
GetGPSSplVolStatus, 7-18 
GetGPSStatus, 7-20 
OpenGPSFile, 7-22 
ProvideGPSPassword, 7-22 
QueueGPSFile, 7-26 
SetGPSControl, 7-29 
SetGPSParams , 7-33 
SetGPSRestart, 7-36 
SetlmageModeGPS, 7-40 
WriteGPSFile, 7-42 



SAM. See Sequential Access Method. 
Sequential Access Method (SAM) 

description of, 1-1 
SetGPSControl, 7-29 
SetGPSParams, 5-2, 5-5, 7-33 
SetGPSRestart, 7-36 
SetlmageModeGPS, 3-3, 7-40 
Spooler 

description of, 2-9 

opening file with QueueGPSFile, 5-5 
■ use of, 2-12 
Standalone workstation 

definition of, 1-2 
Status codes, 8-1 to 8-7 
Status functions 

adding to applications, 5-7 

GetGPSDevHi story, 5-7 

GetGPSDocInfo, 5-7 
Status information, device, 7-55 to 7-56 
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Subscripting 

setting with GPAMSetVerticalOf f set , 4-12 
System service, 

definition of, 2-1 



Text 

assigning attributes, 4-12 
Text attributes 

assigning, 4-12 
Timeout 

after GPAMWriteRecord, 4-13 

setting with GPAMOpen, 4-13 
Troubleshooting, 8-1 to 8-7 



Underscoring 

assigning, 4-12 



Workstation 
cluster, 1-2 
master, 1-3 
standalone, 1-2 

WriteGPSFile, 7-42 
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